API Annuaire SIRENE
Trouvez les professionnels de l'immobilier autour d'une coordonnée GPS grâce aux données SIRENE (INSEE) : agences, notaires, promoteurs, marchands de biens, gestionnaires, courtiers en crédit et bailleurs. Croisez leur présence avec les volumes de transactions DVF pour de l'intelligence concurrentielle.
GET /v1/businesses/search
Recherche géographique d'établissements actifs dans un rayon autour d'un point GPS. Retourne les résultats triés par distance croissante.
Crédits : 5 | Cache : 1h (par combinaison lat/lon/rayon/type)
/v1/businesses/searchParamètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| latitude* | number | — | Latitude du centre de recherche (WGS84) |
| longitude* | number | — | Longitude du centre de recherche (WGS84) |
| radius_m | number | — | Rayon de recherche en mètres (100–5000, défaut : 1000) |
| type | enum | — | agence | notaire | promoteur | gestionnaire | marchand | courtier | bailleur | all (défaut : all) |
| limit | number | — | Nombre maximum de résultats (1–50, défaut : 20) |
| include_dvf_stats | boolean | — | Ajouter le volume DVF (24 mois) et le prix médian /m² du code postal de chaque établissement |
Types de business
agence— Agences immobilières (NAF 6831Z)notaire— Notaires et activités juridiques (NAF 6910Z)promoteur— Promoteurs immobiliers (NAF 4110A–D)gestionnaire— Gestionnaires de biens et syndics (NAF 6832A/B)marchand— Marchands de biens (NAF 6810Z)courtier— Courtiers en crédit immobilier (NAF 6612Z)bailleur— Bailleurs de logements (NAF 6820A)
Exemples
curl "https://mcp.normi.fr/v1/businesses/search?latitude=48.8566&longitude=2.3522&radius_m=500&type=agence" \ -H "X-API-Key: normi_votre_token"
Avec DVF stats (intelligence concurrentielle)
curl "https://mcp.normi.fr/v1/businesses/search?latitude=48.8566&longitude=2.3522&radius_m=1000&include_dvf_stats=true" \ -H "X-API-Key: normi_votre_token"
include_dvf_stats retourne les statistiques DVF du code postal complet de chaque établissement (pas uniquement sa zone de chalandise). Utile pour connaître le marché dans lequel opère l'établissement, pas pour mesurer ses parts de marché individuelles.Réponse
{
"businesses": [
{
"siret": "12345678900012",
"siren": "123456789",
"denomination": "ORPI REPUBLIQUE",
"naf_code": "6831Z",
"business_type": "agence",
"adresse": "12 RUE DE LA REPUBLIQUE",
"code_postal": "75011",
"commune": "PARIS",
"code_departement": "75",
"latitude": 48.8572,
"longitude": 2.3538,
"date_creation": "2005-03-14",
"is_siege": true,
"distance_m": 187
}
],
"count": 8,
"filters": { "latitude": 48.8566, "longitude": 2.3522, "radius_m": 500, "type": "agence" },
"_credits": { "used": 5, "remaining": 495 },
"query_time_ms": 43,
"cache": { "hit": false, "ttl_seconds": 3600 }
}GET /v1/businesses/:siren
Récupère les détails complets d'un établissement via l'API ouverte INSEE en temps réel. Retourne l'établissement siège. Les crédits sont remboursés si le SIREN est introuvable (404).
Crédits : 2 | Note : nécessite que INSEE_API_TOKEN soit configuré côté serveur. Retourne HTTP 503 sinon.
/v1/businesses/:sirenParamètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| siren* | string | — | Numéro SIREN (9 chiffres) — paramètre de chemin |
Exemple
curl "https://mcp.normi.fr/v1/businesses/123456789" \ -H "X-API-Key: normi_votre_token"
Réponse
{
"business": {
"siren": "123456789",
"siret": "12345678900012",
"denomination": "ORPI REPUBLIQUE",
"naf_code": "6831Z",
"etat": "A",
"date_creation": "2005-03-14",
"adresse": "12 RUE DE LA REPUBLIQUE",
"code_postal": "75011",
"commune": "PARIS 11",
"source": "insee_api"
},
"_credits": { "used": 2, "remaining": 498 },
"query_time_ms": 312
}