Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"anyOf": [
{
"anyOf": [
{
"type": "integer",
"maximum": 50,
"minimum": 1
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Nombre de parcelles détaillées retournées par page (défaut 20, max 50)"
},
"siren": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "SIREN du propriétaire personne morale"
},
"offset": {
"anyOf": [
{
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Index de départ pour la pagination (défaut 0). Utiliser pagination.next_offset pour la page suivante."
},
"region": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Nom ou code INSEE de la région, ex: 'Bretagne', 'Île-de-France', '52'. Recherche dans tous ses départements couverts (France métropolitaine hors Corse)."
},
"commune": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Nom de la commune, ex: 'Angers'. Pour une commune homonyme, préciser son code entre parenthèses : 'Thénac (17444)' (code INSEE), 'Thénac (17460)' (code postal) ou 'Thénac (17)' (département)."
},
"date_dpe": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Date d'établissement du DPE. Année (2026 ou '2026'), mois ISO ('2026-09'), jour ISO ('2026-09-15'), ou plage inclusive séparée par un tiret : '2026-09-15-2026-09-30', '2026-09-2026-10', '2019-2024'. Borne ouverte : '2026-09-15-' (minimum), '-2026-09-30' (maximum). Une année ou un mois couvre toute cette année ou ce mois. Ne pas fournir de tableau. Omettre si aucun filtre de date."
},
"viewport": {
"anyOf": [
{
"anyOf": [
{
"type": "object",
"required": [
"sw_lat",
"sw_lng",
"ne_lat",
"ne_lng"
],
"properties": {
"ne_lat": {
"type": "number"
},
"ne_lng": {
"type": "number"
},
"sw_lat": {
"type": "number"
},
"sw_lng": {
"type": "number"
}
}
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Zone géographique explicite (alternative à commune). Hauteur ≤ 20 km pour un détail parcelle par parcelle"
},
"classe_dpe": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G"
],
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Classe énergie d'un logement. Clé exacte: classe_dpe; valeur: une lettre A-G."
},
"classe_ges": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G"
],
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Classe GES. Clé exacte: classe_ges; valeur: une lettre A-G."
},
"date_vente": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Date de vente DVF. Année (2026 ou '2026'), mois ISO ('2026-09'), jour ISO ('2026-09-15'), ou plage inclusive séparée par un tiret : '2026-09-15-2026-09-30', '2026-09-2026-10', '2019-2024'. Borne ouverte : '2026-09-15-' (minimum), '-2026-09-30' (maximum). Une année ou un mois couvre toute cette année ou ce mois. Ne pas fournir de tableau. Omettre si aucun filtre de date."
},
"departement": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Code ou nom du département, ex: '49', 'Maine-et-Loire'. Peut aussi restreindre une commune ou un viewport."
},
"has_piscine": {
"anyOf": [
{
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Uniquement les parcelles avec piscine"
},
"prix_vente_eur": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Prix de la dernière vente DVF en euros. Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum)"
},
"has_copropriete": {
"anyOf": [
{
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "true : parcelles avec une copropriété RNC connue. false non pris en charge ; omettre ne filtre pas ce critère."
},
"conso_dpe_kwh_m2": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Consommation énergie primaire en kWh/m²/an (alternative à classe_dpe). Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum)"
},
"intercommunalite": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Nom ou SIREN d'une intercommunalité, ex: 'CA de La Rochelle', 'agglo de Niort', 'Bordeaux Métropole', '241700434'. Cherche dans toutes ses communes membres, listées dans le résultat avec leur nombre de parcelles."
},
"nombre_batiments": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Nombre de bâtiments sur la parcelle. Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum)"
},
"annee_construction": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Année de construction (BDNB). Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum)"
},
"has_permis_demolir": {
"anyOf": [
{
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Uniquement les parcelles avec un permis de démolir (PD)"
},
"surface_piscine_m2": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Surface de la piscine en m². Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum)"
},
"surface_batiment_m2": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Emprise au sol d'un bâtiment en m². Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum)"
},
"surface_parcelle_m2": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Une seule surface de parcelle en m² par appel. Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum). Un entier seul est quasi exact (tolérance d'arrondi) : pour une surface approximative (« environ 600 m² »), passer une plage, ex: '540-660'. Pour plusieurs surfaces exactes, effectuer un appel séparé par surface; ne jamais fournir de tableau ni de liste séparée par des virgules."
},
"surface_habitable_m2": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Surface habitable (DPE) en m². Nombre ou texte : 250 ou '250' (exact), '100-500' (plage), '100-' (minimum), '-500' (maximum). Un entier seul est quasi exact : pour une surface approximative, passer une plage, ex: '135-145'."
},
"has_permis_construire": {
"anyOf": [
{
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Uniquement les parcelles avec un permis de construire (PC), hors permis de démolir, d'aménager et déclarations préalables"
},
"date_permis_construire": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Date d'autorisation. Avec has_permis_construire ou has_permis_demolir, elle porte sur ce permis ; seule, sur toute autorisation d'urbanisme (permis de construire, de démolir, d'aménager, déclaration préalable). Année (2026 ou '2026'), mois ISO ('2026-09'), jour ISO ('2026-09-15'), ou plage inclusive séparée par un tiret : '2026-09-15-2026-09-30', '2026-09-2026-10', '2019-2024'. Borne ouverte : '2026-09-15-' (minimum), '-2026-09-30' (maximum). Une année ou un mois couvre toute cette année ou ce mois. Ne pas fournir de tableau. Omettre si aucun filtre de date."
},
"has_proprietaire_personne_morale": {
"anyOf": [
{
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": ""
}
]
},
{
"type": "null"
}
],
"description": "Uniquement les parcelles détenues par une personne morale (société, collectivité…)"
}
},
"additionalProperties": false
}