API publique de l'Observatoire

Ce que l'API expose, et ce qu'elle n'expose jamais

Palier gratuit : uniquement les indices déjà publiés sur l'Observatoire (indice de tension, prix moyen au m², nombre de transactions ayant servi au calcul). Jamais de transaction individuelle sur ce palier. Le palier payant donne accès aux transactions individuelles (voir plus bas) ; dans tous les cas, jamais les données du dashboard réseaux sociaux (outil interne), jamais les données brutes DVF non retraitées.

Endpoint

GET /observatoire/api/public/indice?commune=<slug>, en-tête X-Api-Key obligatoire.

curl "https://immogeneration42.com/observatoire/api/public/indice?commune=saint-chamond" \
  -H "X-Api-Key: votre_cle"

Exemple de réponse :

{
  "commune": "Saint-Chamond",
  "slug": "saint-chamond",
  "actualiseLe": "2026-08-16T21:05:00.000Z",
  "prixMoyenM2": 1764,
  "nbTransactions": 118,
  "tension": { "score": 35, "niveau": "equilibre", "fiable": true },
  "attribution": "Données : Immo Generation, Super Observatoire (https://immogeneration42.com/observatoire/). Citation obligatoire en cas d'utilisation publique."
}

Quand un indice n'atteint pas le seuil de fiabilité (15 transactions minimum, même règle que le reste de l'Observatoire), il est renvoyé à null plutôt qu'un chiffre approximatif, jamais masqué silencieusement.

Citation obligatoire

Chaque réponse, y compris en cas d'erreur, contient un champ "attribution" avec le texte exact à reproduire dans toute utilisation publique des données :

« Données : Immo Generation, Super Observatoire (https://immogeneration42.com/observatoire/). Citation obligatoire en cas d'utilisation publique. »

Limite de requêtes

1 requête gratuite par jour et par clé. Au-delà, l'API répond avec le code 429 et un message explicite ; le quota se réinitialise chaque jour. Cette limite s'applique individuellement à chaque clé, jamais de façon globale entre utilisateurs : le quota d'une clé n'est jamais affecté par l'usage d'une autre. La clé interne utilisée par le site et par le widget indice de tension n'est pas concernée par cette limite : ils consomment une route interne distincte, non soumise au système de clé.

Palier payant (29€/mois)

Sans la limite de requêtes du palier gratuit, avec accès aux transactions DVF individuelles (adresse, prix, date, surface) de chaque commune suivie, et à leur export CSV en masse.

Les données DVF sous-jacentes sont elles-mêmes publiques et gratuites sur data.gouv.fr : rien n'est caché ni exclusif. Ce que l'abonnement apporte, ce n'est pas l'accès à la donnée en elle-même, mais son traitement : interrogation directe par API plutôt que téléchargement et manipulation de fichiers CSV volumineux, recalcul automatique qui intègre chaque nouvelle publication DVF sans délai de traitement manuel, et transactions déjà structurées (adresse, prix, date, surface) plutôt que des lignes brutes à nettoyer et croiser soi-même.

GET /observatoire/api/public/transactions?commune=<slug> (pagination offset/limite) et GET /observatoire/api/public/export.csv?commune=<slug>, même en-tête X-Api-Key que l'endpoint /indice, réservés aux clés au palier payant.

"Gérer mon abonnement" ouvre le portail client Stripe (résiliation, moyen de paiement, factures) pour la clé renseignée ci-dessus — réservé aux clés déjà au palier payant.

Différence avec l'explorateur DVF officiel

L'explorateur DVF gratuit (data.gouv.fr) donne accès aux mêmes données sources, mais les fichiers DVF ne sont publiés par la DGFiP que deux fois par an, et leur consultation se fait uniquement à la main, sans accès programmable. L'Observatoire applique un recalcul automatique chaque semaine, intégrant toute nouvelle publication DVF dès sa disponibilité, sans délai de traitement manuel, et expose ce résultat via une API interrogeable directement depuis vos propres outils.

Obtenir une clé

Chaque clé est validée manuellement avant activation, pas d'inscription automatique. Remplissez le formulaire ci-dessous ; vous recevrez votre clé par email une fois la demande approuvée.