 |
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.
L’appel utilise le jeton d’accès fourni par le catalogue.
URL d’accès à la recherche multicritères Siren :
https://api.insee.fr/entreprises/sirene/V3/siren?q={requête multicritères}
URL d’accès à la recherche multicritères Siret :
https://api.insee.fr/entreprises/sirene/V3/siret?q={requête multicritères}
S'il y a d'autres paramètres, on peut avoir par exemple :
https://api.insee.fr/entreprises/sirene/V3/siren?q={requête multicritères}&date={paramètre date}
Le verbe POST permet de s'affranchir de la limite de caractères ou de connecteurs logiques présente dans les requêtes de type GET.
Pour les requêtes de type POST, 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".
Les recherches multicritères sont également accessibles par une console regroupant les principales fonctions.
Pour en savoir plus