estimato — API de valorisation immobilière

Quickstart

Créez un compte, récupérez votre clé API depuis votre espace, puis appelez l'API. Toutes les réponses sont en JSON.

# Estimation d'un appartement de 65 m² à Paris
curl -X POST https://estimato.fr/predict \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"surface":65,"rooms":3,"type":"Appartement","postal_code":"75011","dpe_rating":"D"}'

Base URL — https://estimato.fr. Toutes les requêtes passent en HTTPS.

Authentification

L'API s'authentifie par clé, transmise dans l'en-tête x-api-key de chaque requête. Gardez votre clé secrète (côté serveur uniquement).

x-api-key: sk_live_xxxxxxxxxxxxxxxxxxxx

Vous obtenez et régénérez votre clé depuis votre espace (onglet API), ou via GET /api/access/key une fois connecté.

Limites & plans

Le quota est journalier, par clé. Un 429 est renvoyé au dépassement.

Pro

49 € / mois

1 000 requêtes / jour

API

Sur devis

10 000+ requêtes / jour · SLA · clé dédiée

Entreprise

Sur devis

Volume dédié, white-label, support

Estimation

POST/predictprix, prix/m² et fourchette de confiance

Paramètres (JSON)

Champ	Type	Description
surfacerequis	number	Surface habitable en m².
rooms	integer	Nombre de pièces (défaut 3).
type	string	`Appartement` ou `Maison`.
postal_code	string	Code postal (recommandé pour la localisation).
latitude, longitude	number	Coordonnées exactes (améliorent la précision).
dpe_rating	string	Étiquette DPE `A`–`G`.
surface_terrain	number	Surface du terrain en m² (maisons).

Réponse

{
  "predicted_price": 683000,
  "predicted_price_m2": 10508,
  "confidence_interval": {
    "low": 590550, "high": 776488,
    "low_m2": 9085, "high_m2": 11946
  },
  "inputs": { /* écho des paramètres résolus */ }
}

Rénovation énergétique — exclusivité estimato

Le gain de valeur d'un passage de DPE (ex. G → C), à caractéristiques égales, chiffré et auditable : coût des travaux, gain net, et échéancier légal d'interdiction de location.

POST/api/renovation-scenariovalorisation ajustée du DPE

Paramètres (JSON)

Champ	Type	Description
surfacerequis	number	Surface habitable en m².
current_dperequis	string	Étiquette actuelle `D`–`G`.
target_dpe	string	Étiquette visée (défaut `C`).
rooms, type, postal_code, latitude, longitude	—	Idem `/predict`, pour l'estimation de base.

Réponse

{
  "scenario": {
    "current_dpe": "G", "target_dpe": "C",
    "base_estimate": 683000,
    "value_renovated": 796143,
    "uplift_pct": 16.6, "uplift_eur": 113143,
    "renovation_cost": { "low": 28600, "high": 46800 },
    "net_gain": { "low": 45033, "high": 63233 },
    "rental_ban_year": 2025,
    "evidence": { "scope": "11", "n_obs_segment": 152930 }
  },
  "prediction": { /* réponse /predict complète */ }
}

Cas d'usage banque / assurance — évaluer le risque et le potentiel d'un bien « passoire » (DPE F/G) avant un prêt vert / éco-PTZ, ou tarifer une garantie travaux.

Valorisation de portefeuille — banques & institutions

Valorisez un parc entier en un appel : chaque bien est estimé, les passoires thermiques (DPE F/G) sont signalées, et le potentiel de rénovation est chiffré et agrégé — la matière première d'une décision de prêt vert / éco-PTZ ou d'un arbitrage de collatéral.

POST/api/batch-valuationjusqu'à 100 biens par appel

Paramètres (JSON)

Champ	Type	Description
propertiesrequis	array	Liste de biens (1 à 100). Chaque bien reprend les champs de `/predict` + un `ref` optionnel (votre identifiant, renvoyé tel quel).
target_dpe	string	Étiquette visée pour le calcul de rénovation (défaut `C`).
include_renovation	boolean	Calculer l'upside de rénovation des biens D–G (défaut `true`).

Réponse

{
  "summary": {
    "count": 100, "valued": 100, "errors": 0,
    "total_estimated_value": 38420000,
    "passoires_count": 23,
    "renovation_candidates": 41,
    "total_uplift_potential_eur": 2870000,
    "total_renovation_cost": { "low": 1180000, "high": 1930000 },
    "total_net_gain_eur": { "low": 940000, "high": 1690000 },
    "target_dpe": "C"
  },
  "results": [
    { "ref": "LOAN-8841", "predicted_price": 312000,
      "is_passoire": true, "renovation": { /* scénario complet */ } }
  ]
}

Résilient par bien — une ligne invalide n'interrompt pas le lot : elle est renvoyée avec un error et comptée dans summary.errors. Accès réservé aux forfaits API/Institutions.

Comparables

GET/api/comparablesventes similaires à proximité

Query	Type	Description
lat, lngrequis	number	Point de référence.
surfacerequis	number	Surface du bien (m²).
rooms, type	—	Filtres de similarité.
radius	integer	Rayon en mètres (max 10000).
limit	integer	Nombre de résultats (max 50).

curl "https://estimato.fr/api/comparables?lat=48.86&lng=2.35&surface=65&rooms=3" \
  -H "x-api-key: VOTRE_CLE_API"

Évolution des prix

GET/api/evolutiontendance trimestrielle du prix/m²

Query	Type	Description
postal_code	string	Code postal ciblé.
dept	string	Département (alternatif au code postal).
type	string	`Appartement` / `Maison`.

{ "quarters": [ { "period": "2025-T4", "median_prix_m2": 10333 }, … ] }

Erreurs

401 — clé API manquante ou invalide.
422 — paramètres invalides (ex. surface ≤ 0, DPE inconnu).
429 — quota journalier dépassé.
503 — modèle ou donnée momentanément indisponible.

Passer en production

Palier API (10 000+ req/jour), SLA, white-label ou volume dédié : parlons de votre cas d'usage.

Nous contacter