 |
API Sirene - Documentation des services |
 |
Utilisation des facettes pour les requêtes multicritères : le paramètre min
Le paramètre min permet d’exclure les modalités dont le comptage est inférieur à la valeur choisie.
Exemple sans paramètre min
Parmi les Sociétés par Actions Simplifiées (SAS), ventilation des établissements par nombre de périodes (compris entre 6 et 15 inclus):https://api.insee.fr/api-sirene/3.11/siret?q=categorieJuridiqueUniteLegale%3A57*%20AND%20nombrePeriodesEtablissement%3A%5B6%20TO%2015%5D&facette.champ=categorieJuridiqueUniteLegale%2CnombrePeriodesEtablissement&nombre=0
{
"header": {
"statut": 200,
"message": "OK",
"total": 63181,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "nombrePeriodesEtablissement",
"comptages": [
{
"valeur": "6",
"nombre": 43158
},
{
"valeur": "7",
"nombre": 13389
},
{
"valeur": "8",
"nombre": 4318
},
{
"valeur": "9",
"nombre": 1475
},
{
"valeur": "10",
"nombre": 511
},
{
"valeur": "11",
"nombre": 199
},
{
"valeur": "12",
"nombre": 75
},
{
"valeur": "13",
"nombre": 30
},
{
"valeur": "14",
"nombre": 21
},
{
"valeur": "15",
"nombre": 5
}
]
},
{
"nom": "categorieJuridiqueUniteLegale",
"comptages": [
{
"valeur": "5710",
"nombre": 63024
},
{
"valeur": "5785",
"nombre": 150
},
{
"valeur": "5770",
"nombre": 7
}
]
}
]
}
Exemple avec paramètre min
Parmi les Sociétés par Actions Simplifiées (SAS), ventilation des établissements par nombre de périodes (compris entre 6 et 15 inclus), sans affichage des comptages inférieurs à 100 :https://api.insee.fr/api-sirene/3.11/siret?q=categorieJuridiqueUniteLegale%3A57*%20AND%20nombrePeriodesEtablissement%3A%5B6%20TO%2015%5D&facette.champ=categorieJuridiqueUniteLegale%2CnombrePeriodesEtablissement&nombre=0&facette.min=100
{
"header": {
"statut": 200,
"message": "OK",
"total": 63181,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "nombrePeriodesEtablissement",
"comptages": [
{
"valeur": "6",
"nombre": 43158
},
{
"valeur": "7",
"nombre": 13389
},
{
"valeur": "8",
"nombre": 4318
},
{
"valeur": "9",
"nombre": 1475
},
{
"valeur": "10",
"nombre": 511
},
{
"valeur": "11",
"nombre": 199
}
]
},
{
"nom": "categorieJuridiqueUniteLegale",
"comptages": [
{
"valeur": "5710",
"nombre": 63024
},
{
"valeur": "5785",
"nombre": 150
}
]
}
]
}
Exemples avec paramètre min sur champ
Parmi les Sociétés par Actions Simplifiées (SAS), ventilation des établissements par nombre de périodes (compris entre 6 et 15 inclus), sans affichage des comptages de catégories juridiques inférieurs à 100 :https://api.insee.fr/api-sirene/3.11/siret?q=categorieJuridiqueUniteLegale%3A57*%20AND%20nombrePeriodesEtablissement%3A%5B6%20TO%2015%5D&facette.champ=categorieJuridiqueUniteLegale%2CnombrePeriodesEtablissement&nombre=0&facette.categorieJuridiqueUniteLegale.min=100
{
"header": {
"statut": 200,
"message": "OK",
"total": 63181,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "nombrePeriodesEtablissement",
"comptages": [
{
"valeur": "6",
"nombre": 43158
},
{
"valeur": "7",
"nombre": 13389
},
{
"valeur": "8",
"nombre": 4318
},
{
"valeur": "9",
"nombre": 1475
},
{
"valeur": "10",
"nombre": 511
},
{
"valeur": "11",
"nombre": 199
},
{
"valeur": "12",
"nombre": 75
},
{
"valeur": "13",
"nombre": 30
},
{
"valeur": "14",
"nombre": 21
},
{
"valeur": "15",
"nombre": 5
}
]
},
{
"nom": "categorieJuridiqueUniteLegale",
"comptages": [
{
"valeur": "5710",
"nombre": 63024
},
{
"valeur": "5785",
"nombre": 150
}
]
}
]
}
Recherche des vingt prénoms féminins les plus fréquents, à condition qu'ils aient au moins 50 000 occurrences :
https://api.insee.fr/api-sirene/3.11/siret?q=prenom1UniteLegale:*%20AND%20sexeUniteLegale:F&facette.champ=prenom1UniteLegale&nombre=0&facette.prenom1UniteLegale.min=50000&facette.tri=count:desc&facette.nombre=20
{
"header": {
"statut": 200,
"message": "OK",
"total": 7072737,
"debut": 0,
"nombre": 0
},
"etablissements": [],
"facettes": [
{
"nom": "prenom1UniteLegale",
"comptages": [
{
"valeur": "MARIE",
"nombre": 231913
},
{
"valeur": "ISABELLE",
"nombre": 102672
},
{
"valeur": "CATHERINE",
"nombre": 102458
},
{
"valeur": "NATHALIE",
"nombre": 102244
},
{
"valeur": "ANNE",
"nombre": 86560
},
{
"valeur": "SYLVIE",
"nombre": 84405
},
{
"valeur": "SOPHIE",
"nombre": 77225
},
{
"valeur": "FRANCOISE",
"nombre": 73219
},
{
"valeur": "VALERIE",
"nombre": 71886
},
{
"valeur": "CHRISTINE",
"nombre": 71292
},
{
"valeur": "STEPHANIE",
"nombre": 66184
},
{
"valeur": "MARTINE",
"nombre": 64163
},
{
"valeur": "VERONIQUE",
"nombre": 64129
},
{
"valeur": "CELINE",
"nombre": 62782
},
{
"valeur": "SANDRINE",
"nombre": 61585
},
{
"valeur": "MONIQUE",
"nombre": 54636
},
{
"valeur": "HELENE",
"nombre": 53104
},
{
"valeur": "CAROLINE",
"nombre": 53050
},
{
"valeur": "LAURENCE",
"nombre": 52343
}
]
}
]
}
Commentaires
Dans le dernier exemple, facette.nombre limite les valeurs à 20, mais comme il n'y a pas 20 prénoms cumulant 50 000 occurences, seules 19 valeurs sont affichées. Si l'on diminue le nombre d'occurrences requis, une seule valeur supplémentaire pourra être ajoutée.
Les facettes sont indépendantes par défaut, mais il est possible de les imbriquer.
Le paramètre facette.min n'est pas disponible sur la console.
Pour en savoir plus