API recherche-entreprises data.gouv.fr : guide et intégration OneMCP

L'API recherche-entreprises est l'outil le plus accessible pour interroger les données entreprises françaises : sans authentification, sans limite de quota publiée, maintenue par la DINUM. Voici comment la comprendre et l'utiliser via OneMCP.

Qu'est-ce que l'API recherche-entreprises ?

L'API recherche-entreprises.api.gouv.fr est maintenue par la DINUM (Direction Interministérielle du Numérique) dans le cadre du service public de la donnée. Elle expose les données Sirene de l'INSEE dans une interface REST moderne, sans authentification requise.

Elle est la base technique de plusieurs outils officiels : annuaire-des-entreprises.data.gouv.fr, et de nombreuses intégrations gouvernementales. C'est la source primaire que OneMCP interroge par défaut pour company_search et company_get.

Endpoints principaux

Endpoint	Usage	Paramètre clé
/search	Recherche textuelle	q (requête)
/siren/{siren}	Fiche par SIREN	SIREN 9 chiffres
/siret/{siret}	Fiche par SIRET	SIRET 14 chiffres
/suggest	Autocomplétion	q (requête partielle)

Paramètres de filtrage avancés

L'API supporte des filtres puissants passés via le paramètre fq (filter query) :

etat_administratif:A → entreprises actives uniquement
activite_principale:62.01Z → filtre par code NAF
code_postal:75008 → filtre géographique
departement:69 → filtre par département
tranche_effectif_salarie:[2 TO 5] → tranches d'effectifs

Accéder via OneMCP (sans mémoriser la syntaxe)

{
  "tool": "company_search",
  "params": {
    "query": "agence web Bordeaux",
    "naf": "73.11Z",
    "is_active": true,
    "per_page": 10
  }
}

OneMCP traduit ces paramètres lisibles en syntaxe fq pour l'API recherche-entreprises et normalise la réponse dans le schéma canonique. Vous n'avez pas besoin de connaître la syntaxe de l'API sous-jacente.

Limitations de l'API directe vs OneMCP

Aspect	API directe	Via OneMCP
Authentification	Aucune	Clé OneMCP
Format de réponse	Schéma DGFiP spécifique	Schéma canonique normalisé
Sources	1 (recherche-entreprises)	Multiples consolidées
Résistance aux pannes	Non	Fallback automatique
Quota	Non publié (rate-limited)	1 000/mois offerts

Cas de pannes et fallbacks

L'API recherche-entreprises subit des interruptions périodiques (maintenances, surcharges). OneMCP implémente un fallback automatique vers l'API Sirene v3 de l'INSEE en cas d'erreur HTTP 5xx. Vous ne voyez pas la différence côté client — la réponse arrive toujours.

Données non incluses dans recherche-entreprises

Cette API ne contient pas :

Les bilans financiers → source : RNE/INPI
Les annonces BODACC → source : bodacc.fr
Les marchés publics → source : data.gouv.fr/marches-publics
L'identifiant LEI → source : GLEIF

OneMCP agrège toutes ces sources complémentaires en un seul connecteur.