# Intégrer l'estimation immobilière gratuite sur votre site

> English summary: VendsMonBien offers a free, embeddable price estimate for French homes (apartment or house), built from real recorded sales (DVF, French tax administration). Drop-in `<iframe>`, no API key, no signup. Keep the attribution link and the "indicative estimate" notice. A small public JSON API is also available (rate limited).

Une estimation de prix gratuite, fondée sur les ventes réellement enregistrées autour de l'adresse (données DVF de l'administration fiscale), à intégrer sur un site immobilier, un blog, un site de professionnel ou un projet en cours de développement. Aucune clé, aucune inscription.

Page de référence : https://vendsmonbien.com/estimation-immobiliere-gratuite/
Cette documentation : https://vendsmonbien.com/integrer-estimation-immobiliere/

## Option 1 (recommandée) : l'iframe prête à l'emploi

Collez ce code à l'endroit où l'estimation doit apparaître :

```html
<iframe src="https://vendsmonbien.com/widget/estimation/" title="Estimation immobilière gratuite" loading="lazy" style="width:100%;max-width:440px;height:480px;border:1px solid #eee;border-radius:14px"></iframe>
<p><a href="https://vendsmonbien.com/estimation-immobiliere-gratuite/">Estimation immobilière gratuite par VendsMonBien</a></p>
```

Le visiteur saisit une adresse, choisit appartement ou maison, indique la surface et obtient une fourchette de prix en quelques secondes. Le lien de résultat ouvre vendsmonbien.com dans la fenêtre complète, jamais dans l'iframe du site hôte. Hauteur conseillée : 480 px.

### Conditions d'utilisation

- Gratuit, sans limite d'intégrations, sans contrat.
- Conservez visible, sur la page qui affiche le widget, le lien texte d'attribution du code ci-dessus.
- Conservez la mention « Estimation indicative fondée sur les ventes enregistrées (DVF). Elle ne remplace pas une expertise. », déjà affichée dans le widget. Ne présentez pas le résultat comme une expertise ou une évaluation officielle.
- N'altérez pas les montants affichés.

## Option 2 : l'API JSON (côté serveur, pour une interface personnalisée)

À utiliser seulement si l'iframe ne convient pas. Aucune authentification.

```
GET https://vendsmonbien.com/api/estimation-preliminaire/?lat=<latitude>&lon=<longitude>&type=<appartement|maison>&surface=<m2>
```

Exemple :

```
https://vendsmonbien.com/api/estimation-preliminaire/?lat=47.2184&lon=-1.5536&type=appartement&surface=60
```

Réponse quand des ventes comparables existent :

```json
{"prix_m2": 3626, "nb_transactions": 50, "rayon": 500}
```

- `prix_m2` : prix de vente au m² dans le secteur, en euros.
- `nb_transactions` : nombre de ventes utilisées (jusqu'à 50, mutations portant sur plusieurs locaux écartées, ventes récentes pondérées davantage).
- `rayon` : rayon de recherche retenu, en mètres.

Réponse quand il n'y a pas assez de ventes (moins de 5 comparables, ou zone hors DVF comme l'Alsace-Moselle) :

```json
{"prix_m2": null, "nb_transactions": 0, "rayon": 0, "fallback": true}
```

**Règle impérative : quand `fallback` vaut `true`, ou que `prix_m2` est `null`, n'affichez aucun prix.** Affichez plutôt « pas assez de ventes récentes sur ce secteur pour établir une fourchette fiable ».

Calcul de l'estimation : `prix_m2 × surface`. Le widget affiche une fourchette de plus ou moins 8 % autour de ce montant : c'est une convention d'affichage, pas un intervalle statistique.

Coordonnées : géocodez l'adresse avec la Base Adresse Nationale, gratuite et sans clé : https://api-adresse.data.gouv.fr/search/?q=12+rue+de+la+republique+nantes&limit=5 (coordonnées dans `features[].geometry.coordinates`, dans l'ordre longitude puis latitude).

Limite : 60 requêtes par heure et par adresse IP, au-delà desquelles la requête est refusée. Un appel depuis le serveur de votre site partage donc cette limite entre tous vos visiteurs : pour un site fréquenté, préférez l'iframe, dont la limite s'applique à chaque visiteur séparément.

## Ce que l'estimation ne voit pas

Elle part des prix de vente réels du secteur, pas des caractéristiques du bien : état, étage, exposition, vue et travaux ne sont pas pris en compte. Méthode détaillée : https://vendsmonbien.com/comment-nous-calculons-les-prix/

## Pour aller plus loin

- Données ouvertes : prix médians au m² par commune (Licence Ouverte 2.0), mis à jour chaque mois : https://www.data.gouv.fr/datasets/prix-de-limmobilier-par-commune-agregats-dvf
- Prix commune par commune : https://vendsmonbien.com/prix-immobilier/
- Index pour assistants IA : https://vendsmonbien.com/llms.txt
- Questions ou volume important : https://vendsmonbien.com/contact/