Référence technique

API EstimDVF

Intégrez les estimations immobilières basées sur les données DVF officielles dans vos applications. L'API est disponible avec le plan API à 199€/mois.

Authentification

Toutes les requêtes API doivent inclure votre clé d'accès dans le header X-Api-Key. Retrouvez votre clé dans votre tableau de bord.

curl https://dvfestimator.live/api/estimate \
  -H "X-Api-Key: dvf_votre_clé_ici" \
  -G \
  --data-urlencode "postalCode=75011" \
  --data-urlencode "type=Appartement" \
  --data-urlencode "surface=65"

Endpoint

GET/api/estimate

Paramètre	Type	Requis	Description
`postalCode`	string	Oui	Code postal français (5 chiffres)
`type`	string	Oui	"Appartement" ou "Maison"
`surface`	number	Oui	Surface en m² (5–2000)

Réponse

{
  "postalCode": "75011",
  "city": "Paris 11e Arrondissement",
  "type": "Appartement",
  "surface": 65,
  "medianPricePerM2": 11240,
  "avgPricePerM2": 11580,
  "estimatedPrice": 730600,
  "estimatedMin": 598000,
  "estimatedMax": 871000,
  "comparableSales": 187,
  "lastSaleDate": "2024-11-18",
  "isPro": true,
  "priceHistory": [
    { "year": "2019", "medianPricePerM2": 10200 },
    { "year": "2020", "medianPricePerM2": 10650 },
    { "year": "2021", "medianPricePerM2": 11100 },
    { "year": "2022", "medianPricePerM2": 11400 },
    { "year": "2023", "medianPricePerM2": 11240 }
  ],
  "apiUsage": {
    "count": 42,
    "limit": 10000
  }
}

Codes d'erreur

Code	Signification
`200`	Succès
`400`	Paramètres invalides ou manquants
`401`	Clé API invalide ou absente
`404`	Pas assez de données pour ce secteur
`429`	Limite mensuelle atteinte (10 000 req/mois)
`502`	Service DVF temporairement indisponible

Exemple Node.js

const res = await fetch(
  "https://dvfestimator.live/api/estimate?" +
  new URLSearchParams({ postalCode: "69001", type: "Appartement", surface: "50" }),
  { headers: { "X-Api-Key": process.env.DVF_API_KEY } }
);

const data = await res.json();
console.log(`Estimation: ${data.estimatedPrice} €`);

Exemple Python

import requests

res = requests.get(
    "https://dvfestimator.live/api/estimate",
    params={"postalCode": "33000", "type": "Maison", "surface": 120},
    headers={"X-Api-Key": "dvf_votre_clé_ici"}
)

data = res.json()
print(f"Estimation: {data['estimatedPrice']} €")

Besoin d'aide ?

Notre équipe est disponible pour vous aider à intégrer l'API dans vos applications.

Contacter le support