Aller au contenu principal

Rechercher des parcelles cadastrales

L'API Infoparcelle permet de rechercher et d'analyser les parcelles cadastrales françaises avec leurs géométries complètes, superficies, propriétaires et toutes les données associées. Ce guide vous explique comment utiliser l'endpoint de recherche de parcelles.

Vue d'ensemble

L'endpoint /api/v1/parcelles/recherche vous permet de filtrer les parcelles cadastrales selon de nombreux critères : localisation, superficie, type de bâti, DPE, transactions DVF, risques, etc.

Fonctionnalités principales

  • ✅ Recherche multicritère puissante (67 filtres disponibles)
  • ✅ Filtres géographiques (GPS, code postal, département, commune, IRIS)
  • ✅ Filtres de bâti (type, surface, étages, année de construction)
  • ✅ Filtres énergétiques (DPE, consommations)
  • ✅ Filtres de transactions (DVF, prix, dates)
  • ✅ Géométries complètes (centre, contour, bbox)
  • ✅ Format JSON ou GeoJSON

⚠️ Contrainte importante

Au moins UN filtre géographique est REQUIS parmi :

  • code_departement
  • code_municipalite
  • code_postal
  • code_iris
  • OU la paire de coordonnées GPS (lat ET lon ensemble)

Cette contrainte permet de limiter la portée de la recherche et éviter de scanner toute la France.

Recherche par localisation

Par code postal

curl -X GET \
"https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=75008&limite=10" \
-H "Authorization: Bearer VOTRE_CLE_API"

Par coordonnées GPS

Rechercher les parcelles autour d'un point géographique :

curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?lat=48.8698&lon=2.3080&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Par commune

curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=75108&limite=50" \
-H "Authorization: Bearer VOTRE_CLE_API"

Filtrer par superficie

Trouver de grandes parcelles

curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=69123&superficie_min=1000&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Trouver des petites parcelles

curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=13055&superficie_min=100&superficie_max=300&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Filtrer par type de bâti

Maisons

# Maisons de 3 pièces et plus à Bordeaux
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=33000&bati_type=4,5,6&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Codes des maisons :

  • 1 - Maison (indéterminé)
  • 2 - Maison 1 pièce/studio
  • 3 - Maison 2 pièces
  • 4 - Maison 3 pièces
  • 5 - Maison 4 pièces
  • 6 - Maison 5 pièces et plus

Appartements

# Appartements de 2-3 pièces à Nice
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=06000&bati_type=9,10&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Codes des appartements :

  • 7 - Appartement (indéterminé)
  • 8 - Appartement 1 pièce/studio
  • 9 - Appartement 2 pièces
  • 10 - Appartement 3 pièces
  • 11 - Appartement 4 pièces
  • 12 - Appartement 5 pièces et plus

Terrains à bâtir

# Terrains à bâtir à Toulouse
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=31555&bati_type=16&limite=30" \
-H "Authorization: Bearer VOTRE_CLE_API"

Filtrer par performance énergétique

Trouver des passoires thermiques

# Parcelles avec DPE F ou G à Lille
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=59000&dpe_energie=F,G&limite=30" \
-H "Authorization: Bearer VOTRE_CLE_API"

Trouver des logements performants

# Parcelles avec DPE A, B ou C à Strasbourg
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=67000&dpe_energie=A,B,C&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Étiquettes DPE :

  • A - ≤ 70 kWh/m²/an (Très performant)
  • B - 71-110 kWh/m²/an (Performant)
  • C - 111-180 kWh/m²/an (Assez performant)
  • D - 181-250 kWh/m²/an (Moyennement performant)
  • E - 251-330 kWh/m²/an (Peu performant)
  • F - 331-420 kWh/m²/an (Très peu performant)
  • G - > 420 kWh/m²/an (Passoire thermique)

Filtrer par transactions DVF

Parcelles récemment vendues

# Parcelles vendues depuis 2023 à Nantes
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=44109&dvf_existe=true&dvf_date_min=2023-01-01&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Filtrer par prix de vente

# Parcelles vendues entre 200k et 400k€ à Montpellier
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=34172&dvf_existe=true&dvf_prix_min=200000&dvf_prix_max=400000&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Recherche multicritère avancée

Exemple : Maisons avec piscine

# Maisons de 4 pièces+ avec piscine à Aix-en-Provence
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=13080&bati_type=5,6&piscine=true&superficie_min=500&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Exemple : Appartements récents bien isolés

# Appartements construits après 2010 avec DPE A ou B à Rennes
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_municipalite=35238&bati_type=7,8,9,10,11,12&annee_construction_min=2010&dpe_energie=A,B&limite=30" \
-H "Authorization: Bearer VOTRE_CLE_API"

Format GeoJSON

Pour une intégration directe dans une carte (Leaflet, Mapbox, etc.) :

curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=75008&format=geojson&geometrie=contour&limite=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Types de géométrie disponibles :

  • centre - Point central de la parcelle (défaut)
  • contour - Polygone complet de la parcelle
  • bbox - Boîte englobante
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [[[2.32, 48.85], [2.37, 48.85], ...]]
},
"properties": {
"cadastre_id": "75108000BO0025",
"superficie": 523.45,
"section": {"code": "BO"},
"municipalite": {
"code": "75108",
"nom": "Paris 8e Arrondissement"
}
}
}
]
}

Pagination

Par défaut, l'API retourne 10 résultats. Vous pouvez ajuster ce nombre :

# 50 résultats (maximum)
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=75001&limite=50" \
-H "Authorization: Bearer VOTRE_CLE_API"

# Pagination avec offset
curl "https://app.infoparcelle.fr/api/v1/parcelles/recherche?code_postal=75001&limite=20&offset=20" \
-H "Authorization: Bearer VOTRE_CLE_API"

Obtenir une fiche parcelle complète

Une fois que vous avez trouvé une parcelle intéressante, utilisez son cadastre_id pour obtenir toutes les informations :

# Obtenir la fiche complète d'une parcelle
curl "https://app.infoparcelle.fr/api/v1/parcelles/75108000BO0025" \
-H "Authorization: Bearer VOTRE_CLE_API"

Personnaliser les champs retournés

# Demander uniquement certains champs
curl "https://app.infoparcelle.fr/api/v1/parcelles/75108000BO0025?champs=cadastre_id,superficie,dpes,dvfs,zones_plu,centre" \
-H "Authorization: Bearer VOTRE_CLE_API"

Cas d'usage avancés

1. Détection d'opportunités immobilières

// Trouver des passoires thermiques vendues récemment
async function trouverOpportunites(codePostal) {
const apiKey = process.env.INFOPARCELLE_API_KEY;

const response = await fetch(
'https://app.infoparcelle.fr/api/v1/parcelles/recherche?' +
new URLSearchParams({
code_postal: codePostal,
dpe_energie: 'F,G', // Passoires thermiques
dvf_existe: 'true', // Vendues récemment
dvf_date_min: '2023-01-01',
bati_type: '1,2,3,4,5,6', // Maisons uniquement
superficie_min: '300',
limite: '50',
}),
{
headers: { 'Authorization': `Bearer ${apiKey}` }
}
);

const parcelles = await response.json();

// Calculer le potentiel de rénovation
return parcelles.map(p => ({
cadastre_id: p.cadastre_id,
adresse: p.municipalite.nom,
superficie: p.superficie,
dpe_actuel: p.detail?.dpe_energie,
potentiel: 'Rénovation énergétique',
}));
}

// Utilisation
const opportunites = await trouverOpportunites('69000');
console.log(`${opportunites.length} opportunités trouvées`);

2. Analyse de marché immobilier

async function analyserMarche(codeMunicipalite, anneeMin = 2020) {
/**
* Analyse le marché immobilier d'une commune
*/
const apiKey = process.env.INFOPARCELLE_API_KEY;

const response = await fetch(
'https://app.infoparcelle.fr/api/v1/parcelles/recherche?' +
new URLSearchParams({
code_municipalite: codeMunicipalite,
dvf_existe: 'true',
dvf_date_min: `${anneeMin}-01-01`,
limite: '50',
offset: '0'
}),
{
headers: { 'Authorization': `Bearer ${apiKey}` }
}
);

const parcelles = await response.json();

// Calculer les statistiques
const stats = {
total: parcelles.length,
superficie_moyenne: parcelles.reduce((sum, p) => sum + p.superficie, 0) / parcelles.length,
types_bati: {}
};

parcelles.forEach(p => {
const batiType = p.detail?.caracteristiques?.bati_type;
if (batiType) {
stats.types_bati[batiType] = (stats.types_bati[batiType] || 0) + 1;
}
});

return stats;
}

// Utilisation
const stats = await analyserMarche('75108', 2022);
console.log('Analyse de marché:', stats);

3. Recherche de terrains constructibles

// Trouver des terrains à bâtir en zone U (urbaine)
async function rechercherTerrainsConstructibles(codePostal) {
const apiKey = process.env.INFOPARCELLE_API_KEY;

const response = await fetch(
'https://app.infoparcelle.fr/api/v1/parcelles/recherche?' +
new URLSearchParams({
code_postal: codePostal,
bati_type: '16', // Terrain à bâtir
plu_zone: 'U', // Zone urbaine
superficie_min: '400',
superficie_max: '2000',
limite: '30',
}),
{
headers: { 'Authorization': `Bearer ${apiKey}` }
}
);

return await response.json();
}

// Utilisation
const terrains = await rechercherTerrainsConstructibles('69000');
console.log(`${terrains.length} terrains constructibles trouvés`);

Bonnes pratiques

✅ À faire

  1. Toujours inclure un filtre géographique (requis)
  2. Limiter le nombre de résultats (10-50 selon vos besoins)
  3. Utiliser la pagination pour parcourir de grands ensembles
  4. Combiner les filtres pour affiner vos recherches
  5. Demander uniquement les champs nécessaires avec le paramètre champs
  6. Utiliser GeoJSON pour l'affichage cartographique
  7. Cacher les résultats pour les recherches fréquentes

❌ À éviter

  1. ❌ Oublier le filtre géographique (erreur 400)
  2. ❌ Demander trop de résultats (limite max : 50)
  3. ❌ Ignorer la pagination pour de grands volumes
  4. ❌ Multiplier les requêtes inutiles
  5. ❌ Ne pas gérer les erreurs (timeout, quota dépassé)

Principaux filtres disponibles

Localisation

  • code_departement, code_municipalite, code_postal, code_iris
  • lat, lon (coordonnées GPS)
  • code_section (section cadastrale)

Superficie et surfaces

  • superficie_min, superficie_max
  • surface_habitable_min, surface_habitable_max
  • jardin_min, jardin_max
  • emprise_sol_min, emprise_sol_max

Bâti

  • bati_type (0-17)
  • construction (boolean)
  • annee_construction_min, annee_construction_max
  • etages, hauteur_min, hauteur_max
  • isole, mitoyen

Performance énergétique

  • dpe_energie (A-G)
  • dpe_ges (A-G)
  • dpe_date_reception_min, dpe_date_reception_max

Transactions DVF

  • dvf_existe (boolean)
  • dvf_prix_min, dvf_prix_max
  • dvf_date_min, dvf_date_max
  • dvf_code_type_bien

Piscine

  • piscine (boolean)
  • piscine_surface_min, piscine_surface_max
  • forme_piscine (0-4)

Urbanisme et risques

  • plu_zone, plu_zone_type
  • risque_argile, risque_radon (1-3)

Performances

  • Temps de réponse moyen : < 200ms
  • Cache côté serveur : 15 minutes
  • Rate limit : 1200 requêtes/minute

Voir aussi