- Notifications
You must be signed in to change notification settings - Fork14
Simple python helper to call api.insee.fr api
License
ln-nicolas/api_insee
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
API Sirene donne accès aux informations concernant les entreprises et les établissements immatriculés au répertoire interadministratif Sirene depuis sa création en 1973, y compris les unités fermées. La recherche peut être unitaire, multicritère, phonétique et porter sur les données courantes et historisées. Les services actuellement disponibles interrogent les unités légales (Siren) et les établissements (Siret).
La bibliothéque pythonapi_insee est une aide pour d'interroger l'API Sirene en toute simplicité.Vous trouverez d'avantage d'informations au sujet de l'API Sirene dans ladocumentation officielle
Depuis un terminal :
pip install api-insee
Pour pouvoir interroger l'api vous devez créer un compte consommateur surapi.insee.fr.Puis récupérer vos clés consommateur et secrète.
fromapi_inseeimportApiInseeapi=ApiInsee(key=# clé consommateur,secret=# clé secrète)
- Récupérer les informations à partir d'un numéro sirene ou siret
data=api.siren('005520135').get()data=api.siret('39860733300059').get()# Requêtes envoyées:# https://api.insee.fr/entreprises/sirene/V3/siren/005520135# https://api.insee.fr/entreprises/sirene/V3/siret/39860733300059
- Passer des paramètres à la requête
data=api.siren('005520135',date='2018-01-01').get()# Requête envoyées:# https://api.insee.fr/entreprises/sirene/V3/siren/005520135?date=2018-01-01
- Faire une recherche avancée sur des critères donnés, en utilisant le paramètre
q=
data=api.siren(q='unitePurgeeUniteLegage:True').get()
Les classesapi_insee.criteria permettent de construireles requêtes de recherche avancées plus facilement. Vous trouverez dansla documentation officielle l'ensemble des variables disponibles.
- Vous pouvez par exemple combiner plusieurs critères sur une seulerequête.
fromapi_insee.criteriaimportFielddata=api.siren(q=(Field('codeCommuneEtablissement',92046),Field('unitePurgeeUniteLegale',True))).get()# Requête envoyée:# /?q=codeCommuneEtablissement:92046 AND unitePurgeeUniteLegale:True
- Ou encore en utilisant un dictionnaire
data=api.siren(q={'codeCommuneEtablissement' :92046,'unitePurgeeUniteLegale' :True}).get()# Requête envoyée:# /?q=codeCommuneEtablissement:92046 AND unitePurgeeUniteLegale:True
- Utilisez les opérateurs logiques
|,&,- (not)pour préciser vos requêtes.
data=api.siren(q=(Field('codeCommuneEtablissement',92046)|Field('unitePurgeeUniteLegale',True))).get()data=api.siren(q=-Field('codeCommuneEtablissement',92046)).get()# Requêtes envoyées:# /?q=codeCommuneEtablissement:92046 OR unitePurgeeUniteLegale:True# /?q=-codeCommuneEtablissement:92046
- Filtrer les champs retournés par la réponse
champs= ['siret','denominationUniteLegale','nomUsageUniteLegale','prenom1UniteLegale',]request=api.siret('39860733300059',champs=champs)# Request executed:# /39860733300059?champs=siret,denominationUniteLegale,nomUsageUniteLegale,prenom1UniteLegale
- Interroger le service des liens de succession. (Uniquement disponible depuis la version 1.5 de api_insee)
request=api.liens_succession(q=Criteria.Field('siretEtablissementPredecesseur',39860733300042))# '/liensSuccession?q=siretEtablissementPredecesseur:39860733300042'request=api.liens_succession(q=(Criteria.Field('siretEtablissementPredecesseur','00555008200027')&Criteria.Field('dateLienSuccession','2004-04-01')))# '/liensSuccession?q=siretEtablissementPredecesseur:00555008200027 AND dateLienSuccession:2004-04-01'
| Type | Description | Exemple |
|---|---|---|
| FieldExact | Recherche la valeur exact | FieldExact('demoninationUniteLegale','LE TIMBRE')) |
| Periodic | Recherche sur un champ périodique | Periodic(Field('activitePrincipaleUniteLegale','84.23Z') |
| Range | Recherche sur un interval | Range('nomUsageUniteLegale', 'DUPONT', 'DURANT') |
Pour les requêtes retournant beaucoup de résultats, il est possible de parcourir les résultats grâce à la méthodepages(). Le paramètrenombre spécifie le nombre de résultats par pages. La limite définie par l'insee est 1000 résultats par pages.
fromapi_inseeimportApiInseeapi=ApiInsee(key=# clé consommateur,secret=# clé secrète)request=api.siren(q={'categorieEntreprise':'PME'})for (page_index,page_result)inenumerate(request.pages(nombre=1000)):# votre code ici ..
About
Simple python helper to call api.insee.fr api