Documentation de l'API

Liste paginée des localités, triée par code INSEE. N'expose que les localités actives par défaut ; include_inactive=1 ajoute l'historique (communes fusionnées, supprimées…).

curl "https://georegistry.fr/api/v1/localities?department=49&types[]=commune&per_page=20"

Recherche textuelle avec résolution historique : retrouve une localité même renommée, fusionnée ou devenue commune déléguée/associée. Deux champs clés dans chaque résultat : is_historical_match (correspondance via un alias historique) et matched_alias (le terme qui a déclenché la correspondance).

curl "https://georegistry.fr/api/v1/localities/search?q=Baugé&limit=5"

Localités les plus proches d'un point, triées par distance croissante.

curl "https://georegistry.fr/api/v1/localities/reverse?lat=47.4736&lng=-0.5548"

Localités contenues dans un rayon autour d'un point.

curl "https://georegistry.fr/api/v1/localities/radius?lat=47.4736&lng=-0.5548&radius=15000"

Localités rattachées à un code postal. Un même code peut être partagé par plusieurs communes — la réponse est toujours une collection.

curl "https://georegistry.fr/api/v1/localities/postal-code/49150"

Localités portant un code INSEE donné : la commune et, le cas échéant, ses arrondissements municipaux (Paris, Lyon, Marseille).

curl "https://georegistry.fr/api/v1/localities/insee/49007"

Détail d'une localité (par identifiant interne renvoyé dans les listes) : département et région, alias historiques, entités rattachées (children), statistiques démographiques INSEE (demographics : population, densité, gentilé, tranches d'âge, ménages, revenus, CSP) et statistiques DPE (dpe : répartition A-G, passoires énergétiques, médianes).

curl "https://georegistry.fr/api/v1/localities/12345"

Liste paginée des mutations, triée par date décroissante. Chaque mutation porte ses dispositions (lignes de vente) et leurs parcelles.

curl -H "X-API-Key: geo_votrecle" \
  "https://georegistry.fr/api/v1/dvf/ventes?commune=49007&type_local=2&date_from=2024-01-01"

Dispositions (lignes de vente) géolocalisées dans un rayon autour d'un point, triées par distance croissante.

curl "https://georegistry.fr/api/v1/dvf/ventes/radius?lat=48.8365&lng=2.2403&radius=300"

{
  "data": [
    {
      "adresse": "53 RUE DE LA SAUSSIERE",
      "type_local": "Appartement",
      "surface_bati": 36,
      "valeur_fonciere": 304780,
      "prix_m2": 8466,
      "mutation_date": "2025-08-31",
      "distance_m": 42
    }
  ]
}

Géocode l'adresse via la Base Adresse Nationale puis renvoie les ventes les plus proches. L'adresse résolue est exposée dans meta.address (ou null si le géocodage échoue — la liste est alors vide).

curl "https://georegistry.fr/api/v1/dvf/ventes/address?adresse=12+rue+de+la+Roë+Angers&radius=500"

Résout une parcelle cadastrale par référence (code commune + section + numéro) et renvoie son historique de ventes. 404 si la parcelle n'apparaît dans aucune vente DVF.

curl "https://georegistry.fr/api/v1/dvf/parcelles?insee=49007§ion=0A&numero=0001"

Une parcelle par identifiant Etalab (14 caractères, ex. 490070000A0001) avec toutes les ventes qui l'ont concernée, de la plus récente à la plus ancienne.

curl "https://georegistry.fr/api/v1/dvf/parcelles/490070000A0001?geometry=1"

Estime un bien d'habitation à partir des ventes comparables : fourchette de valeur, prix au m² médian, comparables retenus et indice de confiance. Le bien est localisé par coordonnées, parcelle ou adresse (au moins l'une des trois). Paramètres en JSON (Content-Type: application/json) ou en formulaire.

curl -X POST "https://georegistry.fr/api/v1/dvf/estimate" \
  -H "Content-Type: application/json" \
  -d '{
    "type_local": 2,
    "surface_bati": 62,
    "nombre_pieces": 3,
    "dpe": "D",
    "adresse": "8 boulevard du Roi René, Angers"
  }'

{
  "data": {
    "estimate": 214000,
    "range": { "low": 191000, "high": 238000 },
    "price_per_m2": 3452,
    "confidence": "high",
    "comparables_count": 14
  }
}

Liste paginée des diagnostics, triée par date d'établissement décroissante.

curl "https://georegistry.fr/api/v1/dpe?commune=49007&etiquette=G&type_batiment=maison"

Statistiques agrégées d'une commune (arrondissements municipaux et communes-mères Paris/Lyon/Marseille compris) ou d'un département : répartition par étiquette énergie et climat, part de passoires énergétiques (F+G), médianes (consommation, émissions, surface), détail par type de bâtiment et fenêtre récente (24 derniers mois).

curl "https://georegistry.fr/api/v1/dpe/stats?departement=49"

Régions françaises (avec leurs anciennes régions), triées par nom.

curl "https://georegistry.fr/api/v1/regions"

Anciennes régions (nomenclature d'avant 2016), avec leur région successeur.

curl "https://georegistry.fr/api/v1/former-regions"

Départements, triés par code, avec leur région, leurs statistiques démographiques (demographics) et DPE, leur préfecture et sous-préfectures (COG) et leur préfet/point culminant (Wikidata) lorsqu'ils sont renseignés.

curl "https://georegistry.fr/api/v1/departments"

Cantons, triés par code.

curl "https://georegistry.fr/api/v1/cantons?department=49"

État de santé du service et de ses dépendances (public, sans clé). 200 si tout est opérationnel, 503 si une dépendance critique est indisponible.

{
  "status": "ok",
  "checks": { "database": { "status": "up" }, "redis": { "status": "up" } },
  "providers": { "insee": { "status": "up" } },
  "time": "2026-08-03T09:00:00+02:00"
}