Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Requête sur plusieurs variables

Les mots clés AND et OR sont autorisés et peuvent être combinés avec des parenthèses ; sans parenthèses le AND prévaut sur le OR.

La syntaxe est la suivante :

nomVariable1:valeur1 OR nomVariable2:valeur2
nomVariable1:valeur1 OR nomVariable1:valeur2
nomVariable1:valeur1 AND nomVariable2:valeur2

Pour les variables historisées :

periode(nomVariable1:valeur1 AND/OR nomVariable2:valeur2) recherchera si les conditions sont vérifiées à l'intérieur d'une période (période quelconque, ou fixée par le paramètre date).
periode(nomVariable1:valeur1) AND/OR periode(nomVariable2:valeur2) recherchera sur toutes les périodes les deux conditions séparément, c’est à dire qu'à défaut de paramètre date renseigné, il sélectionnera éventuellement une condition dans une période et une condition dans une autre période.

Il est possible de combiner variables historisées et non-historisées. Dans ce cas, les variables non-historisées n’étant disponibles que pour leur valeur courante, il est préférable de renseigner le paramètre date avec une date dans le furur, de manière à sélectionner également la valeur courante des variables historisées.

Exemples

Recherche de toutes les entreprises dont l’activité principale est 84.23Z ou 86.21Z, ou l’a été par le passé : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=periode(activitePrincipaleUniteLegale:84.23Z OR activitePrincipaleUniteLegale:86.21Z)
Recherche de tous les établissements relevant des catégories juridiques 5510 et 5520 : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:5510 OR categorieJuridiqueUniteLegale:5520
Recherche de tous les établissements qui ont au moins une période où leur état est « actif » et leur activité principale est 84.23Z : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(activitePrincipaleEtablissement:84.23Z AND etatAdministratifEtablissement:A)
Recherche de tous les établissements qui ont moins une période dont l’activitePrincipaleEtablissement est 84.23Z et qui n'ont jamais été fermés : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(activitePrincipaleEtablissement:84.23Z) AND -periode(etatAdministratifEtablissement:F)
Recherche de tous les établissements de Malakoff dont la dernière catégorie juridique est 9220 : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=codeCommuneEtablissement:92046 AND categorieJuridiqueUniteLegale:9220
Recherche de toutes les entreprises exerçant l’activité « marchand de biens » et appartenant à la catégorie PME (Cf. supra : combinaison de variables historisées et non-historisées, paramètre date) : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=periode(activitePrincipaleUniteLegale:68.10Z) AND categorieEntreprise:PME&date=2030-12-31

Commentaires

Quand les nomenclatures évoluent, les codes supprimés sont remplacés pour les unités actives, mais pas pour les unités cessées (Unités légales comme établissements).

Les requêtes sur plusieurs variables sont également accessibles par une console regroupant les principales fonctions. Pour en savoir plus