Bienvenue sur le dépôt de données de l’API de recherche d’Entreprises. Cette API permet de chercher n’importe quelle entreprise de France. Elle fait partie du projet de l'Annuaire des Entreprises.

À propos de l'API

L'API de Recherche des Entreprises est un service qui permet de rechercher et de récupérer des informations sur les entreprises françaises. Elle offre une interface unifiée pour accéder à des données provenant de diverses sources administratives.

Fonctionnalités clés

• Recherche avancée : recherchez des entreprises par nom, SIREN, SIRET, adresse, code NAF, et bien plus encore
• Filtrage : filtrez les résultats par secteur d'activité, localisation géographique, taille d'entreprise, etc.
• Données complètes : accédez à des informations détaillées sur les entreprises, y compris leurs établissements, dirigeants, bilans financiers, etc.
• Performance : des temps de réponse rapides grâce à l'utilisation d'Elasticsearch
• API RESTful : une interface simple et bien documentée pour une intégration facile

Exemples d'utilisation

# Recherche textuelle
curl "https://recherche-entreprises.api.gouv.fr/search?q=DINUM"

# Recherche par SIREN
curl "https://recherche-entreprises.api.gouv.fr/search?q=siren:130025265"

# Recherche avec filtres
curl "https://recherche-entreprises.api.gouv.fr/search?q=Boulangerie&code_postal=13001&code_naf=56.10A"

Architecture du service

Ce dépôt fait partie d'un ensemble de services qui constituent l'Annuaire des Entreprises.

Architecture technique

Composants principaux

• Elasticsearch est le moteur de recherche utilisé pour indexer et requêter sur les données
• FastAPI est le HTTP framework utilisé pour construire l'API
• Sentry est utilisé pour le monitoring et le tracking des erreurs

Flux de traitement

1. Mise à jour des données : mises à jours quotidiennes par l'import de l'index Elasticsearch construit par l'infra data
2. Requête client : un utilisateur envoie une requête HTTP à l'API FastAPI
3. Traitement : FastAPI valide et transforme la requête en une requête Elasticsearch
4. Recherche : Elasticsearch exécute la recherche et retourne les résultats
5. Formatage : FastAPI formate les résultats et les retourne au client
6. Monitoring : Les erreurs et les performances sont pilotées via Sentry et Kibana

Sources de données

👉 Liste des sources de données utilisées pour construire l'index utilisé par l'API de Recherche des Entreprises.

Plus d'informations sur les sources de données par ici 👉.

Contact

Channel Tchap : https://tchap.gouv.fr/#/room/#annuaire-entreprises:agent.dinum.tchap.gouv.fr