{"id":"fcbe1a17-6031-4b80-ad2f-2d13d2023ab8","type":"API","name":"API BDNB Expert","slug":"api-bdnb-expert","description":"L’API Expert va au-delà des données brutes : elle vous donne accès à des indicateurs de performance, des simulations et des analyses enrichies pour piloter vos stratégies immobilières : * Toutes les données BDNB Open et BDNB Expert, avec nos simulations de données manquantes ( DPE, valeurs foncièr…","free_access_class":"FREE_KEY_REQUIRED","auth_type":"API_KEY","homepage_url":"https://www.data.gouv.fr/dataservices/api-bdnb-expert","docs_url":"https://api-portail.bdnb.io/catalog/api/f4905edc-db58-3a3b-a8e5-c5dfc6692ee5/doc?page=1175862d-c3cd-4875-b586-2dc3cd8875d9","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["housing","land"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/f9/08431eec87463182a99b25c624a0d1-100.png","primary_source_url":"https://www.data.gouv.fr/dataservices/api-bdnb-expert","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:49.839Z","updated_at":"2026-09-29T19:06:06.778Z","last_verified_at":"2026-09-26T16:30:09.822Z","deprecated_at":null,"ranking_score":59,"last_ranked_at":"2026-09-20T15:38:32.864Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-09-26T12:54:32.712Z","search_vector":"'a':162B 'acces':161B 'access':54B,128B,198B,272B 'accè':17B 'across':141B,285B 'all':249B 'along':112B,256B 'an':274B 'analys':27B,97B 'analyses':171B,241B 'analyt':139B 'analytical':283B 'and':239B,252B,269B,277B,282B 'api':1A,5B,52B,131B,145A,149B,196B,275B 'as':264B 'au':9B,153B 'au-dela':152B 'au-delà':8B 'avec':42B,186B 'base':65B,209B 'batiment':228B 'batiments':214B 'bdnb':2A,37B,40B,64B,106B,109B,146A,181B,184B,208B,250B,253B 'beyond':86B,230B 'brute':13B 'brutes':157B 'build':74B,88B 'building':218B,232B 'by':221B 'bâtiment':70B,84B 'centr':79B 'centre':223B 'cstb':85B,229B 'data':89B,118B,233B,262B 'databas':75B 'database':219B 'dataset':111B 'datasets':255B 'de':21B,45B,66B,165B,189B,210B 'dela':154B 'delà':10B 'des':11B,19B,23B,26B,69B,155B,163B,167B,170B,213B 'diagnost':123B 'diagnostics':267B 'donn':16B 'donne':160B 'donnees':156B,180B,190B,211B 'donné':12B,36B,46B,67B 'dpe':48B,124B,192B,268B 'du':83B,227B 'ell':14B 'elle':158B 'energi':121B 'energy':265B 'enrich':57B,96B 'enriched':201B,240B 'enrichi':28B 'enrichies':172B 'estat':102B 'estate':246B 'et':25B,39B,81B,169B,183B,225B 'expert':3A,6B,41B,59B,110B,147A,150B,185B,203B,254B 'expert-level':58B,202B 'foncier':194B 'foncièr':50B 'for':260B,280B 'franc':71B,142B 'france':215B,286B 'hous':143C 'immobilieres':177B 'immobilièr':33B 'includ':104B 'including':248B 'indic':93B 'indicateur':20B 'indicateurs':164B 'indicators':237B 'intend':135B 'intended':279B 'is':278B 'it':234B 'key':132B,276B 'l':4B,148B 'land':144C 'les':35B,179B 'level':60B,204B 'maintain':76B 'maintained':220B 'manquant':47B 'manquantes':191B 'miss':117B 'missing':261B 'nation':73B 'national':68B,217B 'nationale':212B 'nos':43B,187B 'of':206B 'offer':91B 'offers':235B 'open':38B,107B,182B,251B 'perform':22B,92B,122B 'performance':166B,236B,266B 'pilot':30B 'piloter':174B 'pour':29B,173B 'profession':137B 'professional':281B 'properti':126B 'property':270B 'provid':53B 'provides':197B 'raw':87B,231B 'real':101B,245B 'real-est':100B 'real-estate':244B 'requir':129B 'requires':273B 's':216B 'scientifiqu':80B 'scientifique':224B 'simul':24B,44B,94B,114B 'simulated':258B 'simulations':168B,188B,238B 'strategi':103B 'strategies':176B 'strategy':247B 'stratégi':32B 'such':263B 'support':99B,243B 'techniqu':82B 'technique':226B 'the':200B,207B,222B 'this':195B 'tier':61B,205B 'to':199B,242B 'tout':34B 'toutes':178B 'use':140B,284B 'va':7B,151B 'valeur':49B 'valeurs':193B 'valu':115B,127B 'values':259B,271B 'vos':31B,175B 'vous':15B,159B 'with':257B 'à':18B","popularity_score":"0.0000","maintenance_score":"0.6000","institution_id":"cc4f65c1-8f0f-42d7-ba35-a02d5ba41e75","institution_type":"AGENCY","country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:49.839Z","geographic_scope":"NATIONAL","name_en":null,"description_en":"This API provides access to the enriched, expert-level tier of the BDNB (Base de Données Nationale des Bâtiments, France's national building database), maintained by the Centre scientifique et technique du bâtiment (CSTB). Beyond raw building data, it offers performance indicators, simulations, and enriched analyses to support real-estate strategy, including all BDNB Open and BDNB Expert datasets along with simulated values for missing data such as energy performance diagnostics (DPE) and property values. Access requires an API key and is intended for professional and analytical use across France.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"reference","trust_score":63.25,"merged_into_entry_id":null,"identity_key":"API|https://www.data.gouv.fr/dataservices/api-bdnb-expert|api bdnb expert","upstream_ref":null,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.bdnb.io/v1/bdnb","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.bdnb.io/v1/bdnb","source":"probe","runnable":true},{"kind":"spec","label":"OpenAPI spec","method":"GET","url":"https://api-management-api.bdnb.io/portal/environments/DEFAULT/apis/f4905edc-db58-3a3b-a8e5-c5dfc6692ee5/pages/1175862d-c3cd-4875-b586-2dc3cd8875d9/content","source":"openapi","runnable":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://api-portail.bdnb.io/catalog/api/f4905edc-db58-3a3b-a8e5-c5dfc6692ee5/doc?page=1175862d-c3cd-4875-b586-2dc3cd8875d9","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-bdnb-expert","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"fcbe1a17-6031-4b80-ad2f-2d13d2023ab8","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"cc4f65c1-8f0f-42d7-ba35-a02d5ba41e75","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-10-01T15:29:59.029Z"},"api_details":{"id":"4ff4ab6e-0397-460a-8ea6-2844e6ddb5d8","entry_id":"fcbe1a17-6031-4b80-ad2f-2d13d2023ab8","base_url":"https://api.bdnb.io/v1/bdnb","openapi_url":"https://api-management-api.bdnb.io/portal/environments/DEFAULT/apis/f4905edc-db58-3a3b-a8e5-c5dfc6692ee5/pages/1175862d-c3cd-4875-b586-2dc3cd8875d9/content","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://api.bdnb.io/v1/bdnb","created_at":"2026-06-07T22:08:49.858Z","updated_at":"2026-06-07T22:08:49.858Z"},"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"4241b04e-aea7-4c2c-8244-e65f3d05c9cf","entry_id":"fcbe1a17-6031-4b80-ad2f-2d13d2023ab8","status":"VERIFIED","last_checked_at":"2026-09-26T16:30:09.568Z","p50_latency_ms":1679,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:19.844Z","updated_at":"2026-09-26T16:30:09.568Z","consecutive_successes":9,"probe_url":"https://api.bdnb.io/v1/bdnb","probe_method":"GET","probe_http_status":403,"probe_content_type":"text/html; charset=utf-8","probe_succeeded_at":"2026-09-26T16:30:09.568Z"},"data_profile":{"id":"50791ebf-c95b-43e7-9e04-65e2d76a4b61","entry_id":"fcbe1a17-6031-4b80-ad2f-2d13d2023ab8","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":null,"field_count":null,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":null,"status":"error","error_message":"OpenAPI spec fetch failed: 500","profiled_at":"2026-09-29T15:42:31.543Z","run_id":"8cecf7c0-e3c5-4c08-bac8-7034e8b00336","created_at":"2026-07-16T22:36:06.221Z","updated_at":"2026-09-29T15:42:31.543Z","license_raw":null,"license_id":null,"consecutive_failure_count":26,"last_error_at":"2026-09-29T15:42:31.543Z","last_error_message":"OpenAPI spec fetch failed: 500","previewable":false,"personal_data":{"status":"none","basis":"no_person_column_cited","grain":"none","allowed":true,"columns":{"direct_identifiers":[],"family_names":[],"given_names":[],"attributes":[],"unresolved_names":[],"measures":[],"entity_identifiers":[]},"publication":null,"publication_evidence":null,"notice":"personal data: no cited column names a natural person (the cited columns are all this reads)"}},"datasets":[],"limits":[],"manifest":{"answer_sha256":"2620b232f18b4756cf9326b8fe0ec9f4c70c3ac223a43be1a3006d31e9b736e9","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":11,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: maturity.rungs[] (7 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-10-01T15:29:59.051Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}