
Vous avez une adresse saisie par un utilisateur et vous voulez afficher les ventes immobilières réelles autour d'elle. Il faut deux briques : l'API Adresse publique pour transformer l'adresse en coordonnées, puis une requête DVF de proximité.
Réponse courte. L'API Adresse de data.gouv.fr, adossée à la Base Adresse Nationale (BAN), est désormais servie par la Géoplateforme de l'IGN à l'adresse https://data.geopf.fr/geocodage/search. Elle est gratuite, sans clé, et renvoie un GeoJSON avec la longitude, la latitude, un score de confiance et le code INSEE. Ces coordonnées se passent ensuite à GET /api/mutations/nearby?lat=…&lng=…&radius=… d'Immo API, qui renvoie les ventes DVF du rayon, triées par distance, avec un champ distance_km.
API Adresse data.gouv : ce qu'elle fait et où elle se trouve en 2026
L'API Adresse géocode une adresse française : elle prend un texte libre (« 8 boulevard du Port Amiens ») et renvoie le point correspondant dans la BAN. Elle sait aussi faire l'inverse, retrouver l'adresse la plus proche d'un point, avec /reverse.
Elle a changé d'opérateur. Historiquement portée par la DINUM sur api-adresse.data.gouv.fr, elle est intégrée au service de géocodage de la Géoplateforme de l'IGN. La documentation d'adresse.data.gouv.fr annonçait la fin de l'ancienne URL pour fin janvier 2026. Le 10 novembre 2026, l'ancienne URL répond encore, mais ses en-têtes portent deprecation et sunset datés du 31 janvier 2026 et un location vers data.geopf.fr. Conclusion : utilisez la nouvelle racine dès maintenant.
| Usage | Ancienne URL | URL à utiliser |
|---|---|---|
| Recherche d'adresse | api-adresse.data.gouv.fr/search/ | data.geopf.fr/geocodage/search |
| Géocodage inverse | api-adresse.data.gouv.fr/reverse/ | data.geopf.fr/geocodage/reverse |
| Géocodage d'un fichier CSV | api-adresse.data.gouv.fr/search/csv/ | data.geopf.fr/geocodage/search/csv |
Les paramètres historiques restent : q, limit, postcode, citycode, type, autocomplete, lat et lon pour favoriser une zone. L'IGN indique une limite de 50 requêtes par seconde et par adresse IP ; au-delà, le service répond 429.
Étape 1 : géocoder une adresse avec l'API Adresse
Un seul appel GET suffit. Gardez limit=1 pour le meilleur résultat, ou plus pour proposer des choix à l'utilisateur.
curl "https://data.geopf.fr/geocodage/search?q=8+boulevard+du+port+amiens&limit=1"
La réponse est un FeatureCollection. Les champs utiles pour la suite :
geometry.coordinates: [longitude, latitude], dans cet ordre (convention GeoJSON). C'est la première source d'erreur : inverser les deux place le point en mer.properties.score: la confiance, entre 0 et 1. Pour notre exemple, 0,97.properties.type:housenumber(numéro trouvé),street(rue seulement),municipality(commune seulement).properties.citycodeetproperties.postcode: code INSEE et code postal, utiles pour filtrer ou contrôler la cohérence.properties.xetproperties.y: coordonnées en Lambert 93, à ne pas confondre avec la latitude et la longitude.
Étape 2 : trouver les ventes DVF autour du point
La route GET /api/mutations/nearby d'Immo API prend lat et lng (pas lon), un rayon radius en kilomètres (5 par défaut, de 0,1 à 50), et des filtres type_local, annee et limit (20 par défaut, 100 au maximum). Elle ne garde que les mutations de nature « Vente », avec une valeur foncière positive et des coordonnées. Chaque ligne reçoit un distance_km, et le tri se fait par distance croissante puis par date décroissante. Le détail est dans la documentation de l'API.
curl "https://immoapi.app/api/mutations/nearby?lat=49.897442&lng=2.290084&radius=0.5&type_local=Appartement&limit=50" -H "x-api-key: dvf_live_VOTRE_CLE"
La réponse contient count, radius_km, center et data, la liste des ventes avec date_mutation, valeur_fonciere, surface_reelle_bati, type_local et les coordonnées.
Le script complet en Python
Ce script enchaîne les deux appels, refuse les géocodages trop incertains, puis calcule un prix au m² médian sur les ventes trouvées.
import statistics, requests
GEO = "https://data.geopf.fr/geocodage/search"
DVF = "https://immoapi.app/api/mutations/nearby"
KEY = "dvf_live_VOTRE_CLE"
def geocoder(adresse):
r = requests.get(GEO, params={"q": adresse, "limit": 1}, timeout=10)
r.raise_for_status()
features = r.json()["features"]
if not features:
return None
f = features[0]
if f["properties"]["score"] < 0.7 or f["properties"]["type"] != "housenumber":
return None # adresse ambiguë : demander une précision
lng, lat = f["geometry"]["coordinates"]
return lat, lng, f["properties"]["label"]
def ventes_autour(adresse, rayon_km=0.5, type_local="Appartement"):
point = geocoder(adresse)
if point is None:
raise ValueError("Adresse introuvable ou trop imprécise")
lat, lng, label = point
r = requests.get(DVF, headers={"x-api-key": KEY}, timeout=15, params={
"lat": lat, "lng": lng, "radius": rayon_km,
"type_local": type_local, "limit": 100,
})
r.raise_for_status()
ventes = r.json()["data"]
prix_m2 = [float(v["valeur_fonciere"]) / v["surface_reelle_bati"]
for v in ventes if v.get("surface_reelle_bati")]
return label, len(ventes), statistics.median(prix_m2) if prix_m2 else None
print(ventes_autour("8 boulevard du Port, Amiens"))
Pour un vrai calcul de prix au m², regroupez d'abord les lignes d'une même mutation multi-lots : la méthode est détaillée dans DVF en Python avec pandas. Pour aller jusqu'à une estimation, voir la méthode des comparables (AVM).
Les pièges à éviter
- L'ordre longitude, latitude. Le GeoJSON de l'API Adresse donne
[lng, lat]. Immo API attend deux paramètres nomméslatetlng. Nommez vos variables explicitement. - Le score et le type. Une adresse mal saisie peut tomber sur le centre d'une rue ou d'une commune. Filtrez sur
scoreet surtype=housenumberavant de chercher des comparables à 300 mètres. - La précision du DVF. Dans les DVF géolocalisées d'Etalab, le point d'une vente est celui de sa parcelle cadastrale, pas de la porte d'entrée. Un rayon de 100 mètres est donc trop serré ; partez de 300 à 500 mètres en ville et élargissez en zone rurale.
- Les zones sans DVF. Le Bas-Rhin, le Haut-Rhin et la Moselle sont absents du DVF : une adresse de Strasbourg se géocode, mais ne renvoie pas de ventes. Voir pourquoi l'Alsace-Moselle manque au DVF.
- Le volume. Pour géocoder des milliers d'adresses, utilisez
/search/csvplutôt que des milliers d'appels, et respectez le 429 de la Géoplateforme.
Quand utiliser cette méthode, et quand en choisir une autre
Le couple API Adresse + /api/mutations/nearby sert les formulaires « saisissez une adresse », les outils d'estimation, les CRM d'agence et les agents IA qui reçoivent une adresse en langage naturel. Pour une rue entière, la logique est différente : voir le prix au m² par rue. Pour relier une vente à une parcelle précise, voir DVF et cadastre. Pour une ville entière, le DVF par commune et GET /api/stats suffisent. Un agent IA peut aussi faire la recherche de proximité via le serveur MCP, avec l'outil search_nearby_mutations (son paramètre de rayon s'appelle radius_km).
FAQ : API Adresse data.gouv et DVF
L'API Adresse data.gouv est-elle gratuite ?
Oui. Le service de géocodage de la Géoplateforme est public, sans clé ni inscription, dans la limite de 50 requêtes par seconde et par adresse IP.
Quelle est la nouvelle URL de l'API Adresse ?
https://data.geopf.fr/geocodage/search pour la recherche et https://data.geopf.fr/geocodage/reverse pour le géocodage inverse. Les paramètres et le format GeoJSON sont les mêmes que sur api-adresse.data.gouv.fr.
Quelle différence entre l'API Adresse et l'API BAN ?
La Base Adresse Nationale est la base de données des adresses. L'API Adresse est le service qui l'interroge pour géocoder. Quand on parle d'« API BAN » pour géocoder, on parle en pratique de ce service.
Comment obtenir le prix de vente des biens autour d'une adresse ?
Géocodez l'adresse pour obtenir latitude et longitude, puis appelez GET /api/mutations/nearby avec lat, lng et radius. Les ventes reviennent triées par distance avec leur valeur foncière.
Pourquoi aucune vente ne remonte pour mon adresse ?
Trois causes fréquentes : un rayon trop petit, une latitude et une longitude inversées, ou une adresse en Alsace-Moselle, absente du DVF. Testez d'abord un rayon de 1 km sans filtre type_local.
Peut-on passer un code postal au lieu d'une adresse ?
Oui. /api/mutations/nearby accepte code_postal seul : le centre est alors la moyenne des coordonnées des ventes de ce code postal. C'est moins précis qu'une adresse géocodée.
Pour démarrer
Le géocodage est gratuit ; la recherche de ventes DVF par proximité demande une clé Immo API. Les offres sont sur la page tarifs, les paramètres complets dans la documentation, et le parcours d'intégration pas à pas dans le guide développeur de l'API DVF.
Articles connexes
API annonces immobilières : SeLoger, Leboncoin, agrégateurs et prix de vente DVF
API annonces immobilières : ce que proposent vraiment SeLoger et Leboncoin, les agrégateurs, les limites légales, et comment comparer une annonce aux ventes DVF en Python.
DVF par commune : télécharger ou interroger les ventes d'une ville
DVF par commune : le CSV Etalab par code INSEE, l'application DVF ou l'API Immo API (ventes et prix au m² médian d'une commune). URL, colonnes, pièges.
DVF Python : analyser les données DVF avec pandas ou une API
Analyser les données DVF en Python : fichiers data.gouv avec pandas (code commune, prix au m², mutations multi-lots) ou API Immo API avec requests.