 |
API Sirene - Documentation des services |
 |
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/api-sirene/3.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/api-sirene/3.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/api-sirene/3.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