Site en construction : la documentation présente dans ce site n’est pas exhaustive pour le moment

logo BDNB logo BDNB Millésime 2026-02.b
  • Concepts
    • La BDNB
    • Bâtiment groupe
    • Le RNB et la BDNB
    • Millésimes et version du schéma
    • Pourquoi des prédictions probabilistes ?
  • Données par thème
    • Vue d’ensemble

    • Bâti, foncier et adresses
    • Référentiels territoriaux
    • Activités, équipements et usages
    • Bâtiments tertiaires
    • Énergie et environnement
    • Logement et marché immobilier
    • Sobriété immobilière
    • Patrimoine et urbanisme
    • Exposition aux aléas
    • Vulnérabilité des personnes

    • Métadonnées
  • Productions BDNB
    • Vue d’ensemble

    • Usages des bâtiments
    • Flux de construction
    • Bâtiments tertiaires
    • Contexte géographique
    • Référentiel administratif

    • Traitement des DPE ADEME
    • Prédiction des performances énergétiques
    • Raccordement aux réseaux de chaleur
    • Valeur foncière et valeur verte des DPE

    • Adaptation au changement climatique
    • Indicateur de surchauffe estivale (ISB)
    • Îlot de chaleur urbain (ICU)
    • Exposition aux aléas

    • Description socio-économique des ménages
  • Recettes
  • FAQ
  • Dictionnaire
    • Dictionnaire interactif
    • Schéma SQL (SchemaSpy)
    • Dictionnaire des données (.xlsx)
  • API
    • Tutoriels
    • Guides
    • Swagger API Open
    • Swagger API Expert
    • Statut
    • Souscrire
  • Releases
    • Télécharger les données
    • Changelog
  • Publications
  1. Api
  2. Accueil
  3. API ${api.proxy.contextPath} version ${api.version}
  • Api
    • Documentation OpenAPI
    • Swagger API Expert
    • Guides API
    • Swagger API Open
    • Tutoriels API
    • Accueil
      • API ${api.proxy.contextPath} version ${api.version}
    • Guides
      • Comment obtenir des informations bâtiments à partir d’identifiants administratifs
      • Comment obtenir des informations bâtiments à partir d’une adresse
      • Comment migrer de l’API gorenove vers l’API BDNB
      • Comment souscrire à une API
    • Tutoriels
      • Comment utiliser l’API BDNB

Sur cette page

  • API ${api.proxy.contextPath} version ${api.version}
    • En savoir plus sur l’API
      • Documentations interactives
      • Premiers pas avec l’API BDNB
    • Nos guides pratiques :
    • Différence entre les API Open, Open+ et Expert
      • Quota et limites d’usages par souscription :
      • Liste des routes de l’API
    • Conditions générales d’utilisation

Other Formats

  • Jupyter
  1. Api
  2. Accueil
  3. API ${api.proxy.contextPath} version ${api.version}

API ${api.proxy.contextPath} version ${api.version}

L’API BDNB est la manière la plus simple d’accéder aux données à jour du dernier millésime de la BDNB.

Vous avez ainsi accès à un vaste ensemble de données géospatiales, constamment à jour, enrichi et amélioré, ainsi qu’à un ensemble de service pour manipuler plus simplement les données qui vous intéressent.

☝ Cette API prend le relais de l’ancienne API Gorenove, désormais en fin de vie

Avec l’API BDNB, vous pouvez ainsi : - 📍 Géocoder vos adresses vers la clé d’interopérabilité de la BAN (Base d’adresses nationale) - 🔎 Accéder aux données des tables de la BDNB à partir des informations à votre disposition (adresse, parcelle , identifiant bâtiment, sélection géospatiale, etc.) - 📤 Exporter ces données aux formats json, geojson ou csv - 🏠 Afficher les données à différentes échelles : bâtiments, iris, commune, epci, département et région avec nos tuiles vectorielles dans des clients cartographiques de type maplibre.

Vous atteignez fréquemment la limite de requête de l’API ? Où vous souhaitez avoir accès à des données expertes ou disponibles sous convention ? –> Demandez l’accès à nos services d’API enrichies –> Comment souscrire?

Un problème avec l’API ? - 📈 Vérifiez la disponibilité de nos services - 📧 Contactez-nous

Vos retours sont précieux, nous prenons vos retours d’expérience et suggestions avec grand plaisir !

En savoir plus sur l’API

Documentations interactives

  • Documentation de l’API Open et Open+ (OpenApi)

  • Documentation de l’API Expert (OpenApi)

  • Le schéma de données courant de la BDNB

Premiers pas avec l’API BDNB

  • Apprendre à faire des requêtes sur l’API BDNB

Nos guides pratiques :

  • Comment souscrire à l’API BDNB -> ajouter dans la FAQ
  • Comment accéder aux données depuis une liste d’adresse ?
  • Comment accéder aux données depuis des identifiants ?
  • Comment migrer de l’API /v2/gorenove vers l’API /v1/bdnb

Différence entre les API Open, Open+ et Expert

Quota et limites d’usages par souscription :

open (pas de souscription) open+ expert
Quota (hit/month/ip) 10k 1M 10M
Nombre maximum d’objets retournés par requête 10 1000 10000
Rate limit 120 / min 1200 /min 1200 /min

Liste des routes de l’API

Usage Disponiblité Route Open Open+ Expert
Géocodage des adresses Disponible GET /v1/bdnb/geocodage ✔ ✔ ✔
Autocomplétion des noms de lieux ou de propriétaires Disponible GET /v1/bdnb/autocompletion ❌ ❌ ✔
Statistiques Disponible GET /v1/bdnb/stats/batiment_groupe ❌ ❌ ✔ (+contenu expert)
Données agrégées par groupe de bâtiments Disponible GET /v1/bdnb/donnees/batiment_groupe_complet ✔ ✔ ✔ (+contenu expert)
Sélection de groupes de bâtiments par clé d’intéropérabilité d’adresse BAN Disponible GET /v1/bdnb/donnees/batiment_groupe_complet/adresse ✔ ✔ ✔ (+contenu expert)
Sélection de groupes de bâtiments par identifiant de parcelle cadastrale Disponible GET /v1/bdnb/donnees/batiment_groupe_complet/parcelle ✔ ✔ ✔ (+contenu expert)
Sélection de groupes de bâtiments par code Siren des propriétaire Q1 2024 GET /v1/bdnb/donnees/batiment_groupe_complet/proprietaire ❌ ❌ ✔ (+contenu expert)
Sélection de groupes de bâtiments par identifiant RNB Q1 2024 GET /v1/bdnb/donnees/batiment_groupe_complet/rnb ✔ ✔ ✔ (+contenu expert)
Sélection spatiale par boîte englobante (bounding box) Disponible GET /v1/bdnb/donnees/batiment_groupe_complet/bbox ✔ ✔ ✔ (+contenu expert)
Sélection spatiale par polygone Disponible GET /v1/bdnb/donnees/batiment_groupe_complet/polygon ❌ ❌ ✔ (+contenu expert)
Données des tables BDNB Disponible GET /v1/bdnb/donnees/{table_bdnb} ✔ ✔ ✔ (+contenu expert)
Tuiles vectorielles MVT : Bâtiments 2D extrudée Disponible GET /v1/bdnb/tuiles/batiment_groupe/{zoom}/{x}/{y}.pbf ✔ ✔ ✔ (+contenu expert)
Tuiles vectorielles MVT : Contours des iris Disponible GET /v1/bdnb/tuiles/iris/{zoom}/{x}/{y}.pbf ✔ ✔ ✔
Tuiles vectorielles MVT : Contours des Communes Disponible GET /v1/bdnb/tuiles/commune/{zoom}/{x}/{y}.pbf ✔ ✔ ✔
Tuiles vectorielles MVT : Contours des EPCI Disponible GET /v1/bdnb/tuiles/epci/{zoom}/{x}/{y}.pbf ✔ ✔ ✔
Tuiles vectorielles MVT : Contours des départements Disponible GET /v1/bdnb/tuiles/departement/{zoom}/{x}/{y}.pbf ✔ ✔ ✔
Tuiles vectorielles MVT : Contours des Régions Disponible GET /v1/bdnb/tuiles/region/{zoom}/{x}/{y}.pbf ✔ ✔ ✔
Information sur les données de la BDNB (nom de colonnes, sources, millésime, description…) Disponible GET /v1/bdnb/metadonnees/ ✔ ✔ ✔

Conditions générales d’utilisation

  • 📖 Conditions Générales d’utilisation (CGU) et garanties de service (SLA)
  • 📈 Voir l’état de disponibilité de nos services
 

Base de Données Nationale des Bâtiments (BDNB) - Centre Scientifique et technique du Bâtiment (CSTB). Réutilisation des contenus : CC BY-SA 4.0