 |
API Sirene - Documentation des services |
 |
Recherche multicritères : Présentation du service
Il est possible via les deux services d’interrogation sur Siren et Siret d'effectuer une recherche libre permettant de combiner la totalité des variables présentes dans la réponse du service unitaire Siren (respectivement Siret).
Cette recherche permet d’obtenir une liste des Siren (respectivement des Siret) qui répondent à des critères passés par un paramètre q (query) prenant la forme d'une requête, éventuellement complétée par les paramètres date, debut, nombre et curseur en fonction des besoins.
Appel du service
Il s’agit d’un service web de type REST, qui s’appuie donc uniquement sur les protocoles et standards utilisés sur le web.
L’invocation du service se fait par envoi d’une requête HTTPS (de type GET ou de type POST) sur une URL publique ; le résultat est communiqué dans le contenu de la réponse HTTPS.
Le type POST permet de s'affranchir de la limite de caractères ou de connecteurs logiques présente dans les requêtes de type GET (limité à environ 2000 caractères). La taille de la requête reste néanmoins limité par la configuration du serveur HTTP, et éventuellement par le client HTTP (navigateur ou autre agent utilisateur). Les paramètres de la requête (q, nombre, etc.) sont fournis dans le corps de la requête POST et l'en-tête doit contenir "Content-Type : application/x-www-form-urlencoded".
Dans les deux cas, GET ou POST, si il y a plus de 1000 connecteurs de type OR ou AND dans la requête, utiliser les parenthèses pour opérer des regroupements de 1000 connecteurs maximum.
L’appel utilise la clé d’accès fourni par le catalogue (accompagné du verbe : GET ou POST).
URL d’accès à la recherche multicritères Siren :
https://api.insee.fr/api-sirene/3.11/siren?q={requête multicritères}
URL d’accès à la recherche multicritères Siret :
https://api.insee.fr/api-sirene/3.11/siret?q={requête multicritères}
S'il y a d'autres paramètres, on peut avoir par exemple :
https://api.insee.fr/api-sirene/3.11/siren?q={requête multicritères}&date={paramètre date}
Les recherches multicritères sont également accessibles par une console regroupant les principales fonctions.
Pour en savoir plus