Référence · Marché & DVF

Marché immobilier d’une commune

GET/v1/market/communes/{code}Droit market:read

Prix au m² des ventes DVF (médiane des 36 derniers mois, ventes hors marché écartées), indice de prix mensuel, correction prix affichés → prix actés, annonces en vente et leur prix affiché médian. Paris, Lyon et Marseille : le code de la ville réunit ses arrondissements (l’indice et la calibration sont alors donnés par arrondissement).

Paramètres

ParamètreTypeDescription
codedans le chemin · requischaîneCode INSEE de la commune (Paris, Lyon, Marseille : code de la ville ou d’un arrondissement).

Réponse 200

ChampTypeDescription
code_communechaîneCode INSEE de la commune.
dvfobjetCouverture DVF.
↳ coveredbooléenCommune couverte par DVF (hors Alsace-Moselle et Mayotte).
↳ sales_countentierVentes d’un logement connues.
↳ first_datepeut être nulldate (AAAA-MM-JJ)Plus ancienne vente.
↳ last_datepeut être nulldate (AAAA-MM-JJ)Plus récente vente.
sold_price_per_sqmobjetMédiane au m² des ventes des 36 derniers mois (ventes hors marché écartées) ; null sous 10 ventes.
↳ appartementpeut être nullobjet
↳ median_price_per_sqmentierPrix médian au m², en euros.
↳ salesentierNombre de ventes.
↳ fromdate (AAAA-MM-JJ)Début de la fenêtre.
↳ todate (AAAA-MM-JJ)Fin de la fenêtre (vente la plus récente).
↳ maisonpeut être nullobjet
↳ median_price_per_sqmentierPrix médian au m², en euros.
↳ salesentierNombre de ventes.
↳ fromdate (AAAA-MM-JJ)Début de la fenêtre.
↳ todate (AAAA-MM-JJ)Fin de la fenêtre (vente la plus récente).
price_indexobjetIndice de prix mensuel par type.
↳ appartementtableau de objet
↳ periodchaîneMois (AAAA-MM).
↳ valuenombreIndice (1 = mois de référence).
↳ median_price_per_sqmpeut être nullnombreMédiane glissante au m².
↳ sample_sizepeut être nullentierVentes de la fenêtre glissante.
↳ maisontableau de objet
↳ periodchaîneMois (AAAA-MM).
↳ valuenombreIndice (1 = mois de référence).
↳ median_price_per_sqmpeut être nullnombreMédiane glissante au m².
↳ sample_sizepeut être nullentierVentes de la fenêtre glissante.
calibrationobjetCorrection prix affichés → prix actés appliquée par le moteur.
↳ appartementpeut être nullobjet
↳ asking_to_sold_rationombreRapport prix actés / prix affichés.
↳ sample_sizeentierVentes rapprochées de leur annonce.
↳ is_defaultbooléenValeur par défaut.
↳ maisonpeut être nullobjet
↳ asking_to_sold_rationombreRapport prix actés / prix affichés.
↳ sample_sizeentierVentes rapprochées de leur annonce.
↳ is_defaultbooléenValeur par défaut.
listingsobjetAnnonces en vente aujourd’hui et prix affiché médian au m² (délai de diffusion du compte appliqué).
↳ activeentierAnnonces en vente.
↳ appartementobjet
↳ countentier
↳ median_asking_price_per_sqmpeut être nullentier
↳ maisonobjet
↳ countentier
↳ median_asking_price_per_sqmpeut être nullentier

Erreurs

400 · Requête invalide401 · Clé absente ou invalide403 · Droit manquant ou accès coupé429 · Limite atteinte503 · Requête trop longue

Toutes les erreurs ont la forme { "error": { "code", "message", "request_id" } } : voir Erreurs.