Documentation de l'API SectorImmo

SectorImmo donne les ventes immobilières réelles (demandes de valeurs foncières) d'une commune ou autour d'une adresse, et les prix au m² par commune. Cette page explique comment l'intégrer.

JSON sur HTTPS
Clé dans l'en-tête X-API-Key
Ventes de 2021 à 2025
1 crédit par appel (2 avec une adresse)

Démarrage

1. Créer un compte gratuit Inscrivez-vous en ligne avec votre e-mail : la clé d'API reçue est la même que pour Adralis, Kompaz et SectorImmo. Sans clé, l'API répond quand même, avec un débit limité, pour essayer.
2. Désigner le lieu Une requête GET avec une adresse, des coordonnées GPS, un code INSEE ou un code postal et une ville, et votre clé dans l'en-tête X-API-Key.
3. Lire les ventes total donne le nombre de ventes trouvées, ventes la page demandée, de la plus récente à la plus ancienne.

Les ventes

curl -H "X-API-Key: VOTRE_CLE" \
  "https://api.nubelo.fr/v1/immobilier/ventes?adresse=37+rue+d%27Arcachon+33000+Bordeaux&perimetre=500m&limite=20"

Désigner le lieu (un seul des quatre, obligatoire)

Avec une adresse, l'adresse est vérifiée avant la recherche : 2 crédits Adralis normalise l'adresse et en tire la position GPS. La recherche n'a lieu que si l'adresse est validée ou corrigée avec certitude. Un crédit sert à SectorImmo, un à cette vérification.

Une adresse non reconnue renvoie 404 et ne coûte rien. Si vous avez déjà vérifié vos adresses, envoyez leurs coordonnées (latitude et longitude) : l'appel ne coûte alors qu'un crédit.

Paramètre	Description	Coût
`adresse`	Adresse en texte libre. Elle est normalisée par Adralis, qui en tire la commune et la position GPS ; la réponse indique l'adresse telle qu'elle a été comprise (`localisation`). Une adresse non reconnue renvoie 404 et ne coûte rien.	2 crédits
`latitude`, `longitude`	Position en degrés décimaux, si vous la connaissez déjà (par exemple après un passage dans Adralis). Il faut alors choisir `perimetre=500m` ou `1km`, ou ajouter `code_insee` pour la commune.	1 crédit
`code_insee`	Code INSEE de la commune (5 caractères, `2A`/`2B` pour la Corse).	1 crédit
`code_postal`, `ville`	Code postal et nom de la commune, ensemble. Le nom de la commune seul ne suffit pas.	1 crédit

Rayon de recherche

Paramètre	Description
`perimetre`	`500m` ou `1km` autour de l'adresse ou des coordonnées, ou `commune` (par défaut) pour toute la commune. Avec une adresse ou des coordonnées, chaque vente porte sa distance en mètres (`distance_m`).

Filtres facultatifs : date, nature, type de bien, prix, surface, pièces, terrain, pagination

Paramètre	Description
`nature`	`vente`, `neuf` (vente en l'état futur d'achèvement), `echange`, `terrain_a_batir`, `adjudication`, `expropriation`. Plusieurs valeurs possibles, séparées par des virgules. Par défaut : `vente,neuf`.
`type_bien`	`maison`, `appartement`, `dependance`, `local_professionnel`, `terrain`. Plusieurs valeurs possibles. Par défaut : `maison,appartement`. Une vente est retenue si au moins un de ses biens correspond.
`date_min`, `date_max`	Dates de vente, au format `AAAA-MM-JJ`.
`prix_min`, `prix_max`	Prix de la vente, en euros.
`prix_m2_min`, `prix_m2_max`	Prix au m², pour les ventes portant sur un seul logement.
`surface_min`, `surface_max`	Surface habitable d'un bien, en m².
`pieces_min`, `pieces_max`	Nombre de pièces d'un bien.
`terrain_min`, `terrain_max`	Surface du terrain, en m².
`limite`, `page`	Taille de la page (20 par défaut, 100 au maximum) et numéro de la page (1 par défaut).

Les critères de type, de surface, de pièces et de terrain portent sur un même bien de la vente : type_bien=appartement&pieces_min=3&surface_min=60 garde les ventes comportant un appartement d'au moins 3 pièces et 60 m².

La réponse

{
  "total": 767,
  "page": 1,
  "limite": 3,
  "ventes": [
    {
      "id": "2025-399813",
      "date": "2025-12-31",
      "nature": "vente",
      "prix": 835000,
      "prix_m2": 3630.43,
      "adresse": {
        "numero": "37",
        "voie": "RUE D ARCACHON",
        "code_postal": "33000",
        "commune": "BORDEAUX",
        "code_insee": "33063"
      },
      "parcelle": "33063000DY0098",
      "latitude": 44.826827,
      "longitude": -0.584111,
      "distance_m": 26,
      "biens": [
        { "type": "maison", "surface": 230, "pieces": 5, "surface_terrain": 324 }
      ]
    }
  ],
  "localisation": {
    "adresse": "37 RUE D ARCACHON, 33000 BORDEAUX",
    "code_insee": "33063",
    "latitude": 44.82665,
    "longitude": -0.58390,
    "precision": "numero",
    "statut": "VALIDE",
    "indice_confiance": 100,
    "saisie": "37 rue d'Arcachon 33000 Bordeaux"
  },
  "source": "DGFiP, Demandes de valeurs foncières ; …"
}

Détail des champs de la réponse

Champ	Description
`total`	Nombre de ventes correspondant à la recherche, toutes pages confondues. Une recherche sans résultat renvoie 200 avec `total` à 0.
`ventes`	La page demandée, de la vente la plus récente à la plus ancienne.
`prix`	Prix de la vente (de l'acte), qui peut porter sur plusieurs biens.
`prix_m2`	Prix au m², présent seulement si la vente porte sur un seul logement.
`adresse`	Adresse du bien, normalisée comme Adralis (majuscules, sans accents).
`parcelle`	Identifiant cadastral de la parcelle.
`distance_m`	Distance en mètres à l'adresse ou aux coordonnées recherchées, quand elles sont connues.
`biens`	Tous les biens de la vente : type, surface, nombre de pièces, surface du terrain.
`localisation`	Seulement pour une recherche par `adresse` : l'adresse telle qu'Adralis l'a comprise, la position utilisée, sa précision (`numero`, `voie` ou `commune`) et l'indice de confiance.

Les statistiques par commune

curl -H "X-API-Key: VOTRE_CLE" \
  "https://api.nubelo.fr/v1/immobilier/stats?code_insee=33063&annee=2025"

Paramètre	Obligatoire	Description
`code_insee`	l'un des deux	Code INSEE de la commune.
`code_postal`, `ville`	l'un des deux	Code postal et nom de la commune, ensemble.
`type_bien`	non	`maison` ou `appartement`. Sans lui, maisons et appartements sont comptés ensemble.
`annee`	non	Une année, par exemple `2024`. Sans elle, toutes les années.

{
  "code_insee": "33063",
  "commune": "Bordeaux",
  "departement": "33",
  "type_bien": "logement",
  "stats": [
    {
      "annee": 2025,
      "ventes": 4516,
      "prix_m2_median": 4267.3,
      "prix_m2_q1": 3548.4,
      "prix_m2_q3": 5105.3,
      "prix_median": 239267,
      "surface_mediane": 62,
      "fiabilite": "bonne"
    }
  ],
  "methode": "…",
  "source": "…"
}

Détail des champs des statistiques

Champ	Description
`prix_m2_median`	Prix médian au m² des ventes de logements de l'année : la moitié des ventes est en dessous, l'autre au-dessus.
`prix_m2_q1`, `prix_m2_q3`	Premier et troisième quartiles : un quart des ventes est sous `q1`, un quart au-dessus de `q3`.
`ventes`	Nombre de ventes de l'année sur lequel reposent les chiffres de la ligne.
`fiabilite`	Indicateur de solidité du chiffre : `bonne` à partir de 10 ventes dans l'année, `faible` de 3 à 9 (chiffre indicatif), `insuffisante` en dessous de 3 (à ne pas utiliser). Elle se calcule sur les ventes de l'année de la ligne.

Les statistiques portent sur les ventes d'un seul logement (maison ou appartement), valeurs aberrantes écartées. Elles couvrent la commune entière.

Erreurs et crédits

Un appel avec clé consomme un crédit Nubelo, ou deux pour la recherche par adresse (un pour SectorImmo, un pour la normalisation de l'adresse par Adralis). Le solde restant est dans l'en-tête X-Credits-Restants (illimite avec l'abonnement illimité). Une requête refusée pour un paramètre invalide, ou pour une adresse non reconnue, ne consomme rien.

Code	Signification
200	Recherche effectuée, avec ou sans vente trouvée.
401	Clé d'API invalide.
402	Crédits épuisés : rechargez votre compte sur compte.nubelo.fr.
404	Adresse non reconnue, ou commune inconnue (les statistiques d'une commune sans vente, ou d'une ville publiée par arrondissement, renvoient aussi 404).
422	Lieu absent ou ambigu (plusieurs désignations à la fois), ou paramètre invalide.
429	Limite de l'essai sans clé atteinte ; l'en-tête `Retry-After` donne le délai en secondes.
502	Le service d'adresses est momentanément indisponible : réessayez.

Les données

La source est le fichier des demandes de valeurs foncières (DVF) de la direction générale des Finances publiques, publié sur data.gouv.fr sous Licence Ouverte. SectorImmo couvre cinq années de ventes (2021 à 2025 aujourd'hui) et les ajoute à mesure que l'administration publie ses fichiers.

Une vente correspond à une mutation enregistrée : elle peut porter sur plusieurs biens et plusieurs parcelles. L'Alsace-Moselle et Mayotte ne sont pas dans la source. Paris, Lyon et Marseille sont publiées par arrondissement. Les ventes sans coordonnées GPS n'apparaissent pas dans une recherche par rayon. La source contient des prix qui ne reflètent pas un marché (vente à 1 €, partage familial) : utilisez prix_min et prix_m2_min pour les écarter.