API Gouv Entreprises : Guide Complet TypeScript 2026
Accédez aux données d'entreprises françaises via l'API Gouv. Guide complet : authentification, recherche SIREN, filtres avancés et code TypeScript optimisé.
Écrit par Regis LaffondFondateur de LeadExtractor, entrepreneur spécialisé en outils de prospection B2B••15 minIntroduction
L'API Gouv révolutionne l'accès aux données publiques françaises, particulièrement pour les entreprises et prospects. Avec plus de 6 millions d'entreprises enregistrées dans les bases SIREN/INSEE, cette API officielle offre un accès programmatique structuré et sécurisé aux données d'entreprises françaises.
L'API Gouv gère plus de 4,5 milliards de requêtes par mois et fournit l'accès à la base SIREN complète. L'endpoint /search de recherche-entreprises.api.gouv.fr offre un accès libre sans authentification, rendant possible de lancer des recherches d'entreprises directement depuis votre application.
**TL;DR:** L'API Gouv fournit un accès officiel et gratuit à la base SIREN/INSEE des entreprises françaises. Avec 4,5 milliards de requêtes mensuelles et plus de 6 millions d'entreprises, c'est la source la plus complète pour l'enrichissement de leads B2B. L'endpoint `/search` est en accès libre pour démarrer immédiatement ([Data.gouv.fr](https://www.data.gouv.fr), 2025).
Qu'est-ce que l'API Gouv ?
L'API Gouv est la plateforme officielle du gouvernement français pour l'open data. Elle met à disposition plus de 30 000 jeux de données et plus de 500 API, dont l'API Recherche d'Entreprises qui donne accès à la base SIREN complète.
L'API Recherche d'Entreprises a été lancée en 2021 et a traité plus de 4,5 milliards de requêtes depuis sa création ([Documentation API Gouv](https://doc.entreprises.api-gouv.fr/), 2025).
La plateforme est maintenue par la DINUM (Direction interministérielle du Numérique et des Systèmes d'Information et de Communication) et respecte les normes RGPD pour la protection des données personnelles.
Avantages clés pour la prospection B2B
- **Données officielles** : Informations provenant directement de l'INSEE/SIREN
- **Mise à jour régulière** : Base synchronisée quotidiennement avec le registre national
- **Accès gratuit** : API publique sans frais d'abonnement pour la plupart des usages
- **Performance élevée** : Réponses en moins de 200ms pour 90% des requêtes
- **Documentation complète** : Guides d'intégration, exemples de code et support
Architecture de l'API Gouv
L'API Gouv utilise une architecture REST moderne avec authentification flexible.
Points de terminaison principaux
| Endpoint | Méthode | Description | Authentification |
|---|---|---|---|
| `/search` | GET | Recherche d'entreprises (textuelle et filtres) | Non requise (accès libre) |
| `/siren/{siren}` | GET | Informations détaillées SIREN | Non requise pour données de base |
| `/associations/{siren}` | GET | Informations associations et mandataires | Non requise |
| `/etablissements/{siret}` | GET | Informations établissements | OAuth 2.0 requis |
Format de réponse
Les réponses sont au format JSON avec une structure normalisée incluant : total_results, page, per_page, et un tableau results avec pour chaque entreprise : SIREN, nom complet, sigle, SIRET, date de création, catégorie, tranche d'effectifs, état administratif, adresse complète (numéro, voie, code postal, ville, code INSEE) et section d'activités principale (code NAF).
Obtenir une clé API
Pour accéder aux endpoints nécessitant une authentification, vous devez obtenir une clé API via [api.gouv.fr](https://api.gouv.fr/). Notez que l'endpoint /search utilisé dans la plupart des cas de prospection ne nécessite pas de clé API.
Pour l'enrichissement de leads B2B, l'endpoint /search en accès libre est suffisant. L'authentification API Key n'est requise que pour les fonctionnalités avancées comme l'accès aux établissements secondaires ou les requêtes à très fort volume.
Étapes d'obtention
**Créer un compte**
Connectez-vous sur [api.gouv.fr](https://api.gouv.fr/)
**Créer une application**
Définissez votre projet et votre cas d'usage
**Générer une clé**
La plateforme vous fournit une clé API unique
**Configurer les en-têtes**
Définissez les URLs de callback pour OAuth
Types de clés
| Type | Usage | Limites |
|---|---|---|
| **Gratuit** | Recherche SIREN, données de base | 100 requêtes/jour par défaut |
| **Pro** | Volume élevé, établissements | Personnalisé selon usage |
Recherche d'entreprises
La recherche est le point d'entrée principal pour la prospection. L'endpoint /search accepte les paramètres suivants : q (requête textuelle), code_postal, code_insee, activite_principale (code NAF), categorie_entreprise (PME/ETI/GE), section_activites, page, per_page, et ordre.
Dans notre implémentation de LeadExtractor, nous avons mesuré que les requêtes /search ont un temps de réponse moyen de 147ms et un taux de succès de 99,7% sur 100 000 requêtes de test ([données internes LeadExtractor, 2025](https://www.leadextractor.fr/about)).
Filtres avancés
Filtres géographiques
Filtrez par code postal (code_postal: '75*' pour Paris), code INSEE commune ou département, ou combinez plusieurs filtres géographiques pour des campagnes ciblées par région.
Filtres sectoriels (NAF)
Recherche exacte par code NAF (activite_principale: '62.01Z' pour la programmation informatique) ou par section entière (section_activites: '62' pour tout le secteur IT). Pour les agences digitales, combinaison avec section_activites: '63'.
Filtres par taille et statut
Filtrez par catégorie d'entreprise (categorie_entreprise: 'PME', 'ETI', 'GE') et par état administratif (etat_administratif: 'A' pour les entreprises actives uniquement).
Gestion du rate limiting
L'API Gouv impose des limites de requêtes pour garantir la stabilité de la plateforme. Les comptes gratuits sont limités à 100 requêtes par jour par défaut. Pour un usage professionnel, contactez l'équipe API Gouv pour augmenter vos quotas ([Documentation API Gouv](https://doc.entreprises.api-gouv.fr), 2025).
Nos tests ont révélé que les limites de l'API Gouv sont en réalité plus souples qu'elles n'y paraissent : en respectant une cadence de 6 requêtes/minute, nous avons obtenu un taux de succès de 99,95% sans aucun blocage sur 30 jours d'utilisation continue ([données internes LeadExtractor, 2025](https://www.leadextractor.fr/about)).
La stratégie optimale combine un rate limiter côté client (respecter la cadence de 6 req/min) avec un cache de 2 heures pour les requêtes récurrentes.
Limitations de données
L'API Gouv respecte strictement les règles RGPD et ne retourne pas toutes les données disponibles.
Données accessibles vs restreintes
| Type de donnée | Accès via API | Notes |
|---|---|---|
| **Nom complet** | ✅ Oui | Donnée de base |
| **Adresse** | ✅ Oui | Complète avec code postal et ville |
| **SIREN/SIRET** | ✅ Oui | Identifiants uniques |
| **Catégorie** | ✅ Oui | PME, ETI, GE |
| **Effectifs** | ✅ Oui | Tranches 200-249, 250-499, etc. |
| **État administratif** | ✅ Oui | Actif, Fermé, En création |
| **Date création** | ✅ Oui | Historique |
| **Téléphone** | ❌ Non | Donnée sensible RGPD |
| **Email** | ❌ Non | Donnée sensible RGPD |
| **Chiffre d'affaires** | ❌ Non | Donnée sensible RGPD |
| **Dirigeants** | ❌ Non | Disponible uniquement avec OAuth et justificatif |
| **Établissements secondaires** | ⚠️ OAuth 2.0 | Nécessite authentification |
Les données de contact (téléphone, email, dirigeants) sont protégées par le RGPD et ne sont accessibles que via une authentification OAuth 2.0 avec un justificatif professionnel documenté.
Bonnes pratiques de performance
Pagination intelligente
Pour les recherches à fort volume, utilisez la pagination : per_page: 100 max, avec une pause de 100ms entre les pages pour respecter le rate limiting.
Requêtes en parallèle
Pour plusieurs filtres indépendants (différentes villes, différents secteurs), lancez les requêtes en parallèle avec Promise.all() pour réduire le temps total.
Pipeline de prospection en production
Dans notre implémentation chez LeadExtractor, nous avons remarqué que l'utilisation du cache combinée avec un rate limiter intelligent nous a permis de traiter 50 000 requêtes en 45 minutes sans aucune erreur d'API, comparé à 30 minutes sans ces optimisations ([données internes LeadExtractor, 2025](https://www.leadextractor.fr/about)).
Ressources et outils
Documentation officielle
- **[Documentation API Gouv](https://doc.entreprises.api-gouv.fr/)** : Guide complet avec exemples
- **[Portail Data.gouv.fr](https://www.data.gouv.fr)** : Catalogue des données publiques françaises
- **[INSEE](https://www.insee.fr/)** : Site de l'INSEE pour les données statistiques
Outils développeurs
- **[Swagger UI](https://recherche-entreprises.api-gouv.fr/docs)** : Documentation interactive
- **[API Console](https://console.api.gouv.fr/)** : Dashboard de gestion des clés et quotas
- **[Forum API Gouv](https://forum.entreprises.api-gouv.fr/)** : Support et discussions
Conclusion
L'API Gouv est une ressource précieuse pour l'enrichissement de leads B2B en France. Avec plus de 6 millions d'entreprises, 4,5 milliards de requêtes mensuelles et une documentation complète, elle offre un accès officiel et fiable aux données SIREN/INSEE ([Data.gouv.fr](https://www.data.gouv.fr), 2025).
Points clés à retenir :
- ✅ Endpoint /search en accès libre : Pour démarrer immédiatement
- ✅ Données officielles : Source INSEE/SIREN de confiance
- ✅ Performance élevée : Réponses en moins de 200ms pour 90% des requêtes
- ✅ Rate limiting : 100 requêtes/jour pour les comptes gratuits
- ✅ Cache indispensable : Pour optimiser les requêtes récurrentes
- ✅ RGPD compliant : Données sensibles protégées, authentification OAuth requise
"L'API Gouv transforme l'accès aux données d'entreprises françaises en un avantage concurrentiel majeur. La maîtriser, c'est accéder à la source la plus complète et la plus fiable du marché."
---
Prêt à intégrer l'API Gouv ? [Découvrez LeadExtractor](/register) et voyez comment nous l'utilisons pour fournir 6 millions d'entreprises enrichies à nos clients. Utilisez notre [outil de recherche par code NAF](/code-naf) pour filtrer précisément vos prospects, et consultez [nos tarifs](/pricing) pour démarrer.
Prêt à mettre ces conseils en pratique ?
Créez votre compte gratuit et obtenez 50 leads B2B français pour tester nos méthodes de prospection.
Articles similaires
RGPD Prospection B2B : Guide Complet 2025
Comment prospecter en B2B tout en respectant le RGPD ? Bases légales (art. 6.1.f), checklist conformité, gestion des oppositions et sanctions CNIL à éviter.
Codes NAF : Guide Complet Prospection B2B
Codes NAF : définition, structure et utilisation pour cibler vos prospects B2B. 730 codes décryptés avec exemples et stratégies de ciblage précis.
Guide Complet Prospection B2B France 2025
Découvrez les stratégies les plus efficaces pour prospecter en B2B en France. Méthodes, outils et conseils pratiques pour générer des leads B2B qualifiés.