Retour au blog
api adresse data gouvAPI BANgéocodageDVFAPI

API Adresse data.gouv + DVF : géocoder une adresse et trouver les ventes autour

IM

Immo API

·7 min de lecture
API Adresse data.gouv + DVF : géocoder une adresse et trouver les ventes autour

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.

UsageAncienne URLURL à utiliser
Recherche d'adresseapi-adresse.data.gouv.fr/search/data.geopf.fr/geocodage/search
Géocodage inverseapi-adresse.data.gouv.fr/reverse/data.geopf.fr/geocodage/reverse
Géocodage d'un fichier CSVapi-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.

API Adresse data.gouv et DVF : adresse saisie, géocodage Géoplateforme, coordonnées, requête nearby, ventes triées par distance

É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.citycode et properties.postcode : code INSEE et code postal, utiles pour filtrer ou contrôler la cohérence.
  • properties.x et properties.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).

Champs utiles de l'API Adresse data.gouv pour la requête DVF : coordinates longitude latitude, score, type housenumber, citycode

Les pièges à éviter

  • L'ordre longitude, latitude. Le GeoJSON de l'API Adresse donne [lng, lat]. Immo API attend deux paramètres nommés lat et lng. 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 score et sur type=housenumber avant 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/csv plutôt que des milliers d'appels, et respectez le 429 de la Géoplateforme.
Checklist géocodage DVF : ordre longitude latitude, score minimum, rayon adapté, Alsace-Moselle, géocodage CSV en masse

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.