Documentation

API Parcelle Info

Version 0.1.0 · schéma /openapi.json

Ce que renvoie l'API

Chaque valeur est un fait, jamais un nombre nu. Un fait porte sa source, l'URL appelée, sa date, sa licence, et surtout sa maille de jointure : ce qui dit si la valeur décrit ce bien ou la moyenne de son secteur. C'est la seule chose que cette API apporte qu'un appel direct aux sources ne donne pas — ne l'ignorez pas.

`geometry_match`	Ce que la valeur décrit	Précis ?
`parcel_id`	cette parcelle	oui
`rnb_id`	ce bâtiment	oui
`ban_id`	cette adresse	oui
`immeuble`	cet immeuble	oui
`point_in_polygon`	cet endroit précis	oui
`radius`	le voisinage	non
`udi`	tout ce réseau de distribution	non
`commune`	toute la commune	non
`epci`	toute l'intercommunalité	non
`iris`	le quartier	non
`nearest`	l'objet le plus proche	non
`derived`	un calcul à partir des données ci-dessus	non

Résultats partiels

Une source lente ou en panne ne fait jamais échouer la réponse. Chaque bloc porte un status — ok, partial, timeout, error, not_covered, skipped — et un message. Un not_covered signifie que la source ne couvre pas cet endroit, pas que la donnée vaut zéro.

Points d'entrée

`GET /v1/resolve`

Résout une entrée en parcelle cadastrale

Renvoie le contexte de résolution ; `status = ambiguous` liste des candidats.

Paramètre	Type	Requis
`q`	string	oui

curl 'https://parcelle-info.fr/v1/resolve?q=382+Rue+des+Alpes+38150+Boug%C3%A9-Chambalud'

`GET /v1/profile`

Profil complet d'une parcelle, à partir d'une adresse ou d'une référence

Paramètre	Type	Requis
`q`	string	oui
`blocks`	string	non

curl 'https://parcelle-info.fr/v1/profile?q=382+Rue+des+Alpes+38150+Boug%C3%A9-Chambalud'

`GET /v1/profile.html`

La même fiche, en HTML autonome

Paramètre	Type	Requis
`q`	string	oui

curl 'https://parcelle-info.fr/v1/profile.html?q=382+Rue+des+Alpes+38150+Boug%C3%A9-Chambalud'

`GET /v1/parcel/{parcel_id}`

Profil d'une parcelle par son identifiant cadastral

Paramètre	Type	Requis
`parcel_id`	string (chemin)	oui
`blocks`	string	non

curl 'https://parcelle-info.fr/v1/parcel/38051000AI0261'

`GET /v1/parcel/{parcel_id}/{block}`

Un seul bloc du profil

Paramètre	Type	Requis
`parcel_id`	string (chemin)	oui
`block`	string (chemin)	oui

curl 'https://parcelle-info.fr/v1/parcel/38051000AI0261/risks'

`GET /v1/sources`

Registre des sources et de leurs licences

Sert à générer la page « Sources et licences » du site.

curl 'https://parcelle-info.fr/v1/sources'

`GET /healthz`

Sonde de vivacité

curl 'https://parcelle-info.fr/healthz'

`GET /metrics`

Compteurs par source et par bloc

curl 'https://parcelle-info.fr/metrics'

Limites et obligations

Plafond par adresse IP, sans clé d'API pour l'instant. Un dépassement renvoie 429 ; espacez les appels plutôt que de les répéter.
Les données sont publiques, en Licence Ouverte 2.0 sauf mention contraire. Le champ attributions de chaque réponse contient l'attribution à conserver : elle n'est pas décorative, elle est exigée par les licences.
Ce service n'est ni un certificat d'urbanisme, ni l'état des risques réglementaire (ERRIAL), ni une estimation immobilière. Le champ disclaimers le rappelle dans chaque réponse.
Aucune donnée nominative de propriétaire n'est collectée ni renvoyée.

Serveur MCP

Les mêmes données sont exposées à un agent par un serveur MCP (parcelle-mcp, transport stdio), avec dix outils qui appellent exactement le même code que cette API. Les réponses y portent aussi attributions et disclaimers.