entreprises_in_radius
Find French companies within a geographic radius using latitude, longitude, and distance. Optionally filter by NAF code to target specific sectors.
Instructions
Recherche d'entreprises françaises avec filtres NAF, code postal, département ou rayon géographique. Couvre tous secteurs (santé via NAF 8690B, 4773Z, 8710A, 8621Z, etc.). Source : DINUM Recherche Entreprises (SIRENE + RNE). Renvoie CA, dirigeants, tranches d'effectif et dates de création.
Deux modes EXCLUSIFs (endpoints DINUM distincts) : (1) proximité — lat+lon+radiusKm (optionnellement + naf), résolu nativement via /near_point ; (2) administratif — q (texte libre) et/ou naf + codePostal/departement, via /search. La recherche de proximité ne supporte PAS q ni codePostal/departement (combinaison rejetée avec une erreur explicite : choisir un seul mode). radiusKm borné à 50 km.
Réduction de payload (V0.13) : includeDirigeants: false strip la liste des dirigeants RNE de chaque entreprise du résultat — utile en énumération volume (Geo Intel) où les dirigeants ne sont pas exploités et où les groupes type Biogroup peuvent en lister 20+ par entité (gonflement inutile du payload). Défaut true pour préserver le contrat V0.12 (backward-compat strict).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| naf | No | Code NAF principal (ex: '8690B' = labos, '4773Z' = pharmacies, '8710A' = EHPAD, '8621Z' = MG). | |
| q | No | Recherche textuelle libre (raison sociale, dirigeant…). | |
| lon | No | Longitude du centre du cercle de recherche. | |
| lat | No | Latitude du centre du cercle de recherche. | |
| radiusKm | No | Rayon en km (1-50). | |
| codePostal | No | Filtre alternatif : code postal exact. | |
| departement | No | Filtre alternatif : code département. | |
| perPage | No | Résultats par page (1-25, défaut 10). | |
| page | No | Page (1-indexed). | |
| includeDirigeants | No | Inclure la liste des dirigeants RNE dans chaque entreprise (défaut true). `false` strip `dirigeants: []` côté handler — utile en énumération volume où les dirigeants ne sont pas exploités (économie de tokens, groupes type Biogroup peuvent lister 20+ dirigeants par entité). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Total d'entreprises matchant la query côté DINUM. | |
| page | Yes | ||
| perPage | Yes | ||
| totalPages | Yes | ||
| entreprises | Yes | Entreprises retournées (SIREN, nomComplet, NAF, finances, etablissements). |