Documentation de l'API DVF

Reference complete de l'API DVF pour acceder aux donnees de transactions immobilieres en France. Tous les endpoints, parametres et exemples de reponses.

URL de base

https://immoapi.app/v1

Authentification

Toutes les requetes doivent inclure un header Authorization avec votre cle API au format Bearer token.

Authorization: Bearer YOUR_API_KEY

Obtenez votre cle API en creant un compte sur Immo API. La cle est disponible immediatement apres inscription dans votre tableau de bord.

Limites de requetes

Les limites varient selon votre plan :

Plan	Limite	Fenetre
Starter	1 000 requetes	Par jour
Pro	Illimite	-

Les headers de reponse incluent X-RateLimit-Remaining et X-RateLimit-Reset pour suivre votre consommation.

GET

/v1/mutations

Recherchez des transactions immobilieres (mutations) dans la base DVF. Filtrez par commune, departement, type de bien, fourchette de prix et periode.

Parametres

Parametre	Type	Statut	Description
`code_commune`	string	optionnel	Code INSEE de la commune (ex: 75056 pour Paris)
`code_departement`	string	optionnel	Code du departement (ex: 75, 69, 13)
`type_local`	string	optionnel	Type de bien : Appartement, Maison, Local industriel, Dependance
`annee`	integer	optionnel	Annee de la transaction (ex: 2024)
`prix_min`	integer	optionnel	Prix minimum en euros
`prix_max`	integer	optionnel	Prix maximum en euros
`surface_min`	integer	optionnel	Surface minimale en m2
`surface_max`	integer	optionnel	Surface maximale en m2
`page`	integer	optionnel	Numero de page (defaut: 1)
`per_page`	integer	optionnel	Resultats par page, max 100 (defaut: 20)

Exemple de requete

curl "https://immoapi.app/v1/mutations?code_commune=75056&type_local=Appartement&annee=2024&prix_min=200000&prix_max=600000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemple de reponse

{
  "total": 842,
  "page": 1,
  "per_page": 20,
  "mutations": [
    {
      "id": "dvf-2024-75056-00142",
      "date_mutation": "2024-03-15",
      "nature_mutation": "Vente",
      "valeur_fonciere": 485000,
      "code_commune": "75056",
      "nom_commune": "Paris",
      "code_departement": "75",
      "adresse": "12 Rue de Rivoli, 75001 Paris",
      "code_postal": "75001",
      "type_local": "Appartement",
      "surface_reelle_bati": 65,
      "nombre_pieces": 3,
      "surface_terrain": null,
      "prix_m2": 7461,
      "longitude": 2.3488,
      "latitude": 48.8566
    }
  ]
}

GET

/v1/mutations/nearby

Recherchez les transactions immobilieres a proximite d'un point geographique (latitude / longitude). Ideal pour trouver des comparables dans un quartier.

Parametres

Parametre	Type	Statut	Description
`lat`	float	requis	Latitude du point central
`lng`	float	requis	Longitude du point central
`radius`	integer	optionnel	Rayon de recherche en metres (defaut: 1000, max: 5000)
`type_local`	string	optionnel	Type de bien : Appartement, Maison
`annee`	integer	optionnel	Annee de la transaction
`page`	integer	optionnel	Numero de page (defaut: 1)
`per_page`	integer	optionnel	Resultats par page, max 100 (defaut: 20)

Exemple de requete

curl "https://immoapi.app/v1/mutations/nearby?lat=48.8566&lng=2.3522&radius=500&type_local=Appartement" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemple de reponse

{
  "total": 38,
  "radius_m": 500,
  "center": {
    "lat": 48.8566,
    "lng": 2.3522
  },
  "mutations": [
    {
      "id": "dvf-2024-75056-00891",
      "date_mutation": "2024-02-20",
      "valeur_fonciere": 520000,
      "adresse": "5 Place du Chatelet, 75001 Paris",
      "type_local": "Appartement",
      "surface_reelle_bati": 55,
      "prix_m2": 9454,
      "distance_m": 120
    }
  ]
}

GET

/v1/stats

Obtenez des statistiques agregees sur les transactions immobilieres : prix median et moyen au m2, volume de transactions, evolution annuelle. Filtrez par zone geographique et periode.

Parametres

Parametre	Type	Statut	Description
`code_commune`	string	optionnel	Code INSEE de la commune
`code_departement`	string	optionnel	Code du departement
`code_region`	string	optionnel	Code de la region
`annee`	integer	optionnel	Annee (defaut: derniere annee disponible)
`type_local`	string	optionnel	Type de bien : Appartement, Maison

Exemple de requete

curl "https://immoapi.app/v1/stats?code_departement=75&annee=2024&type_local=Appartement" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemple de reponse

{
  "code_departement": "75",
  "nom_departement": "Paris",
  "annee": 2024,
  "type_local": "Appartement",
  "nombre_transactions": 28100,
  "prix_median_m2": 10250,
  "prix_moyen_m2": 11340,
  "surface_moyenne": 52,
  "valeur_fonciere_mediane": 415000,
  "evolution_annuelle": -2.3,
  "repartition_pieces": {
    "1": 5200,
    "2": 8900,
    "3": 7800,
    "4": 4100,
    "5+": 2100
  },
  "prix_m2_par_trimestre": {
    "T1": 10400,
    "T2": 10300,
    "T3": 10150,
    "T4": 10100
  }
}

Codes d'erreur

Code HTTP	Signification	Description
`400`	Bad Request	Parametres invalides ou manquants
`401`	Unauthorized	Cle API manquante ou invalide
`429`	Too Many Requests	Limite de requetes atteinte
`500`	Internal Server Error	Erreur serveur, reessayez plus tard

{
  "error": {
    "code": 401,
    "message": "Cle API invalide ou manquante",
    "detail": "Verifiez que le header Authorization contient un Bearer token valide."
  }
}

A propos de la documentation Immo API

Cette documentation couvre l'ensemble des endpoints de l'API DVF. L'API permet d'acceder aux donnees officielles de transactions immobilieres en France issues des Demandes de Valeurs Foncieres (DVF). Que vous construisiez un outil d'estimation, un tableau de bord analytique ou une application immobiliere, cette documentation vous guide pas a pas dans l'integration de l'API transaction immobiliere.