Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Utilisation des facettes pour les requêtes multicritères : le paramètre prefixe

Le paramètre prefixe permet de n’inclure que les facettes commençant par le préfixe saisi.

Exemple sans paramètre prefixe

Comptage des établissements de personnes physiques, selon le prénom :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000%20AND%20prenom1UniteLegale:*&facette.champ=prenom1UniteLegale&nombre=0
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 18828764,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "prenom1UniteLegale",
            "comptages": [
                {
                    "valeur": "JEAN",
                    "nombre": 625505
                },
                {
                    "valeur": "MICHEL",
                    "nombre": 262050
                },
                {
                    "valeur": "MARIE",
                    "nombre": 234594
                },
                {
                    "valeur": "PHILIPPE",
                    "nombre": 226854
                },
                {
                    "valeur": "PIERRE",
                    "nombre": 225693
                },
                {
                    "valeur": "ALAIN",
                    "nombre": 190397
                },
                {
                    "valeur": "PATRICK",
                    "nombre": 156344
                },
                {
                    "valeur": "BERNARD",
                    "nombre": 151599
                },
                {
                    "valeur": "JACQUES",
                    "nombre": 145340
                },
                {
                    "valeur": "CHRISTIAN",
                    "nombre": 145314
                }
            ]
        }
    ]
}

Exemple avec paramètre prefixe

Comptage des établissements de personnes physiques, selon le prénom, s'il commence par un "P" :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000%20AND%20prenom1UniteLegale:*&facette.champ=prenom1UniteLegale&nombre=0&facette.prefixe=P
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 18828764,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "prenom1UniteLegale",
            "comptages": [
                {
                    "valeur": "PHILIPPE",
                    "nombre": 226854
                },
                {
                    "valeur": "PIERRE",
                    "nombre": 225693
                },
                {
                    "valeur": "PATRICK",
                    "nombre": 156344
                },
                {
                    "valeur": "PASCAL",
                    "nombre": 112996
                },
                {
                    "valeur": "PAUL",
                    "nombre": 76673
                },
                {
                    "valeur": "PATRICE",
                    "nombre": 52184
                },
                {
                    "valeur": "PATRICIA",
                    "nombre": 48124
                },
                {
                    "valeur": "PASCALE",
                    "nombre": 32220
                },
                {
                    "valeur": "PAULINE",
                    "nombre": 28623
                },
                {
                    "valeur": "PAULETTE",
                    "nombre": 16240
                }
            ]
        }
    ]
}

Commentaires

Attention : le paramètre facette.prefixe ne fonctionne pas avec les chiffres.
S'agissant du prénom, potentiellement composé de plusieurs mots, la requête avec facette.prefixe=P n'est pas exactement équivalente à la requête https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000%20AND%20prenom1UniteLegale:P*&facette.champ=prenom1UniteLegale&nombre=0
Le paramètre prefixe.modalite n'est pas disponible sur la console.
Pour en savoir plus