 |
API Sirene - Documentation des services |
 |
Requêtes multicritères : la pondération des variables
Il est possible dans le cas d’une recherche multicritère sur plusieurs variables de privilégier une ou plusieurs variables par rapport aux autres.
La syntaxe est la suivante :
q=ponderation(NomVariable1*p1 NomVariable2*p2 … : {recherche}) où p1, p2 sont des coefficients qui peuvent être décimaux (avec des . comme délimiteur décimal).
Exemple sans pondération
Recherche d'établissements pour lesquels la dénomination ou le sigle de l'unité légale contiennent Insee (les 10 plus pertinents) :https://api.insee.fr/api-sirene/3.11/siret?q=sigleUniteLegale:insee OR denominationUniteLegale:insee&champs=siret,score,sigleUniteLegale,denominationUniteLegale&nombre=10
{
"header": {
"statut": 200,
"message": "OK",
"total": 148,
"debut": 0,
"nombre": 10
},
"etablissements": [
{
"score": 18.726704,
"siret": "44523905600010",
"uniteLegale": {
"denominationUniteLegale": "CENTRALE TRAVAILLEURS UNIS INSEE",
"sigleUniteLegale": "CTU INSEE"
}
},
{
"score": 13.341082,
"siret": "42344016300016",
"uniteLegale": {
"denominationUniteLegale": "CGT INSEE GUYANE",
"sigleUniteLegale": null
}
},
{
"score": 13.013793,
"siret": "47832593900013",
"uniteLegale": {
"denominationUniteLegale": "INSEE PARIS CLUB",
"sigleUniteLegale": null
}
},
{
"score": 12.77219,
"siret": "41153297100016",
"uniteLegale": {
"denominationUniteLegale": "CGT INSEE REUNION",
"sigleUniteLegale": null
}
},
{
"score": 12.399337,
"siret": "41024114500011",
"uniteLegale": {
"denominationUniteLegale": "CAFET'INSEE LILLE",
"sigleUniteLegale": null
}
},
{
"score": 11.705198,
"siret": "78368560500017",
"uniteLegale": {
"denominationUniteLegale": "FOYER DE L INSEE",
"sigleUniteLegale": null
}
},
{
"score": 11.4161415,
"siret": "78431200100042",
"uniteLegale": {
"denominationUniteLegale": "SYNDICAT NATIONAL CFTC INSEE",
"sigleUniteLegale": null
}
},
{
"score": 11.4103365,
"siret": "77566626600033",
"uniteLegale": {
"denominationUniteLegale": "MUTUELLE DE L'INSEE",
"sigleUniteLegale": null
}
},
{
"score": 11.35861,
"siret": "12002701600431",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 11.35861,
"siret": "17130270600014",
"uniteLegale": {
"denominationUniteLegale": "INST NAT STATISTIQUE ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
}
]
}
Exemple avec pondération
Recherche d'établissements pour lesquels la dénomination ou le sigle de l'unité légale contiennent Insee (les 10 plus pertinents, en privilégiant le sigle) :https://api.insee.fr/api-sirene/3.11/siret?q=ponderation(sigleUniteLegale*2 denominationUniteLegale*1:insee)&champs=siret,score,sigleUniteLegale,denominationUniteLegale&nombre=10
{
"header": {
"statut": 200,
"message": "OK",
"total": 148,
"debut": 0,
"nombre": 10
},
"etablissements": [
{
"score": 22.71218,
"siret": "12002701600233",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 22.71218,
"siret": "12002701600431",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 22.71218,
"siret": "17130270600014",
"uniteLegale": {
"denominationUniteLegale": "INST NAT STATISTIQUE ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 22.71218,
"siret": "17540270000017",
"uniteLegale": {
"denominationUniteLegale": "INST NAT STATISTIQUE ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 22.71218,
"siret": "17590270900039",
"uniteLegale": {
"denominationUniteLegale": "INST NAT STATISTIQUE ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 21.686008,
"siret": "12002701600290",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 21.686008,
"siret": "12002701600464",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 21.686008,
"siret": "17250270000013",
"uniteLegale": {
"denominationUniteLegale": "INST NAT STATISTIQUE ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 21.686008,
"siret": "12002701600043",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
},
{
"score": 21.686008,
"siret": "12002701600167",
"uniteLegale": {
"denominationUniteLegale": "INSTITUT NATIONAL DE LA STATISTIQUE ET DES ETUDES ECONOMIQUES",
"sigleUniteLegale": "INSEE"
}
}
]
}
Exemple avec pondération inverse
Recherche d'établissements pour lesquels la dénomination contient Insee (les 10 plus pertinents, en privilégiant la dénomination) :https://api.insee.fr/api-sirene/3.11/siret?q=ponderation(sigleUniteLegale*1 denominationUniteLegale*2:insee)&champs=siret,score,sigleUniteLegale,denominationUniteLegale&nombre=10
{
"header": {
"statut": 200,
"message": "OK",
"total": 148,
"debut": 0,
"nombre": 10
},
"etablissements": [
{
"score": 26.685375,
"siret": "42344016300016",
"uniteLegale": {
"denominationUniteLegale": "CGT INSEE GUYANE",
"sigleUniteLegale": null
}
},
{
"score": 26.023264,
"siret": "47832593900013",
"uniteLegale": {
"denominationUniteLegale": "INSEE PARIS CLUB",
"sigleUniteLegale": null
}
},
{
"score": 25.54438,
"siret": "41153297100016",
"uniteLegale": {
"denominationUniteLegale": "CGT INSEE REUNION",
"sigleUniteLegale": null
}
},
{
"score": 24.834982,
"siret": "41024114500011",
"uniteLegale": {
"denominationUniteLegale": "CAFET'INSEE LILLE",
"sigleUniteLegale": null
}
},
{
"score": 23.410397,
"siret": "78368560500017",
"uniteLegale": {
"denominationUniteLegale": "FOYER DE L INSEE",
"sigleUniteLegale": null
}
},
{
"score": 22.832283,
"siret": "78431200100042",
"uniteLegale": {
"denominationUniteLegale": "SYNDICAT NATIONAL CFTC INSEE",
"sigleUniteLegale": null
}
},
{
"score": 22.816002,
"siret": "77566626600033",
"uniteLegale": {
"denominationUniteLegale": "MUTUELLE DE L'INSEE",
"sigleUniteLegale": null
}
},
{
"score": 22.397272,
"siret": "78431200100034",
"uniteLegale": {
"denominationUniteLegale": "SYNDICAT NATIONAL CFTC INSEE",
"sigleUniteLegale": null
}
},
{
"score": 22.07262,
"siret": "31625273300019",
"uniteLegale": {
"denominationUniteLegale": "ASSOCIATION PERSONNEL INSEE TOULOUSE",
"sigleUniteLegale": "APIT"
}
},
{
"score": 22.07262,
"siret": "77566626600074",
"uniteLegale": {
"denominationUniteLegale": "MUTUELLE DE L'INSEE",
"sigleUniteLegale": null
}
}
]
}
Exemple avec pondération de mots pour une même variable ; variable historisée
Recherche d'une unité légale dont la dénomination contient le mot café ou le mot sports (le plus pertinent, en privilégiant fortement sports) :https://api.insee.fr/api-sirene/3.11/siren?q=ponderation(denominationUniteLegale*4:sports) OR ponderation(denominationUniteLegale*1:café)&champs=siren,score,sigleUniteLegale,denominationUniteLegale&nombre=1
{
"header": {
"statut": 200,
"message": "OK",
"total": 26562,
"debut": 0,
"nombre": 1
},
"unitesLegales": [
{
"score": 33.225132,
"siren": "059800979",
"sigleUniteLegale": null,
"periodesUniteLegale": [
{
"dateFin": null,
"dateDebut": "1994-12-25",
"denominationUniteLegale": "GUEYDAN SPORTS ARTICLE SPORTS"
},
{
"dateFin": "1994-12-24",
"dateDebut": "1959-12-25",
"denominationUniteLegale": "GUEYDAN SPORTS ARTICLE SPORTS"
},
{
"dateFin": "1959-12-24",
"dateDebut": "1959-01-01",
"denominationUniteLegale": "GUEYDAN SPORTS ARTICLE SPORTS"
},
{
"dateFin": "1958-12-31",
"dateDebut": "1900-01-01",
"denominationUniteLegale": null
}
]
}
]
}
Recherche d'une unité légale dont la dénomination contient le mot café ou le mot sports (le plus pertinent, en privilégiant légèrement sports) : https://api.insee.fr/api-sirene/3.11/siren?q=ponderation(denominationUniteLegale*2:sports) OR ponderation(denominationUniteLegale*1:café)&champs=siren,score,sigleUniteLegale,denominationUniteLegale&nombre=1
{
"header": {
"statut": 200,
"message": "OK",
"total": 26562,
"debut": 0,
"nombre": 1
},
"unitesLegales": [
{
"score": 19.855856,
"siren": "342713476",
"sigleUniteLegale": null,
"periodesUniteLegale": [
{
"dateFin": null,
"dateDebut": "1996-12-25",
"denominationUniteLegale": "CAFE DES SPORTS"
},
{
"dateFin": "1996-12-24",
"dateDebut": "1994-01-01",
"denominationUniteLegale": "CAFE DES SPORTS"
},
{
"dateFin": "1993-12-31",
"dateDebut": "1993-01-01",
"denominationUniteLegale": "SOC HOTELIERE ET RESTAURATION DE CREIL"
},
{
"dateFin": "1992-12-31",
"dateDebut": "1987-10-08",
"denominationUniteLegale": "CAFE DES SPORTS"
},
{
"dateFin": "1987-10-07",
"dateDebut": "1900-01-01",
"denominationUniteLegale": null
}
]
}
]
}
Recherche d'une unité légale dont la dénomination contient le mot café ou le mot sports (le plus pertinent, en privilégiant légèrement café) : https://api.insee.fr/api-sirene/3.11/siren?q=ponderation(denominationUniteLegale*1:sports) OR ponderation(denominationUniteLegale*2:café)&champs=siren,score,sigleUniteLegale,denominationUniteLegale&nombre=1
{
"header": {
"statut": 200,
"message": "OK",
"total": 26562,
"debut": 0,
"nombre": 1
},
"unitesLegales": [
{
"score": 20.588547,
"siren": "542058243",
"sigleUniteLegale": null,
"periodesUniteLegale": [
{
"dateFin": null,
"dateDebut": null,
"denominationUniteLegale": "CAFE DES SPORTS CAFE 76"
}
]
}
]
}
Recherche d'une unité légale dont la dénomination contient le mot café ou le mot sports (le plus pertinent, en privilégiant fortement café) : https://api.insee.fr/api-sirene/3.11/siren?q=ponderation(denominationUniteLegale*1:sports) OR ponderation(denominationUniteLegale*4:café)&champs=siren,score,sigleUniteLegale,denominationUniteLegale&nombre=1
{
"header": {
"statut": 200,
"message": "OK",
"total": 26562,
"debut": 0,
"nombre": 1
},
"unitesLegales": [
{
"score": 40.88976,
"siren": "419597471",
"sigleUniteLegale": null,
"periodesUniteLegale": [
{
"dateFin": null,
"dateDebut": "2003-12-25",
"denominationUniteLegale": "CAFE CAFE"
},
{
"dateFin": "2003-12-24",
"dateDebut": "2000-01-01",
"denominationUniteLegale": "CAFE CAFE"
},
{
"dateFin": "1999-12-31",
"dateDebut": "1998-12-25",
"denominationUniteLegale": "CAFE CAFE"
},
{
"dateFin": "1998-12-24",
"dateDebut": "1998-07-15",
"denominationUniteLegale": "CAFE CAFE"
}
]
}
]
}
Commentaires
Pour les variables historisées cette pondération ne tient compte que des valeurs courantes : il n'est pas nécessaire d'utiliser le terme "periode".
La recherche avec pondération peut être combinée avec d'autres recherches.
La recherche avec pondération est disponible sur la console. Pour en savoir plus