Vérifier un bien avant de l'acheter
De l'adresse de l'annonce à ce que dit le cadastre et à ce que voit le satellite : de quelle finca il s'agit, ce qu'elle contient, si elle se trouve dans un espace protégé et si le sol bouge. Chaque étape utilise une parcelle différente pour montrer un cas avec des données ; dans votre flux, c'est la même référence du début à la fin.
Pays: ES
1. De l'adresse à la finca
Une adresse en texte libre renvoie des candidats classés par indice de confiance (de 0 à 1) avec la référence à 14 caractères, l'usage, les logements et l'année. À partir de 0,75, le numéro et la commune correspondent. Cela coûte 1 unité uniquement s'il y a des candidats.
curl -G "https://api.parcelgps.com/v1/search/address/candidates" \
--data-urlencode "q=Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas" \
--data-urlencode "limit=3" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Réponse réelle
{
"success": true,
"data": {
"query": {
"text": "Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas",
"street": "Avenida José Rodríguez de la Borbolla Camoyán",
"number": 10,
"municipality": "Dos Hermanas"
},
"candidates": [
{
"reference": "0745901TG4304N",
"country": "ES",
"address": "AVENIDA JOSE RGUEZ BORBOLLA CAMOY 10",
"number": 10,
"postalCode": "41704",
"municipality": "Dos Hermanas",
"region": "Sevilla",
"latitude": 37.31947088654626,
"longitude": -5.926788955974699,
"confidence": 0.93,
"numberMatches": true,
"municipalityMatches": true,
"inOwnCopy": true,
"cadastreAddress": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"use": "Residencial",
"dwellings": 346,
"yearBuilt": 2023
},
{
"reference": "0747201TG4304N",
"country": "ES",
"address": "BULEVAR JOSE RODRIGUEZ DE LA BORBOLLA CAMOYAN 11",
"number": 11,
"confidence": 0.55,
"numberMatches": false,
"municipalityMatches": true,
"inOwnCopy": true
}
],
"attribution": "CartoCiudad (Instituto Geográfico Nacional) y Dirección General del Catastro"
},
"remainingSearches": 2894
}2. Ce qu'elle contient : logements, locaux et annexes
Avec la référence à 14 caractères, vous obtenez toutes les unités de la finca avec usage, surface, étage, porte et quote-part. Cela permet de vérifier que la surface et l'usage indiqués dans l'annonce correspondent au cadastre. Cela coûte 1 unité par unité servie.
curl "https://api.parcelgps.com/v1/parcels/0745901TG4304N/units" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Réponse réelle
HTTP/2 200
etag: "5ab6bd3d95f85dddba81818bcb0cb65e"
cache-control: private, max-age=21600
x-quota-remaining: 2893
{
"success": true,
"data": {
"reference": "0745901TG4304N",
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"postalCode": "41704",
"municipality": "DOS HERMANAS",
"region": "Sevilla",
"mainUse": "Residencial",
"totalArea": 32789,
"yearBuilt": 2023,
"unitCount": 200,
"propertyUnitCount": 365,
"units": [
{
"reference": "0745901TG4304N0002KH",
"staircase": "",
"floor": "01",
"door": "B",
"use": "Residencial",
"area": 155,
"description": "Planta 01, Pta. B - Residencial",
"ownershipShare": 0.279543,
"yearBuilt": 2023,
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:B"
},
{
"reference": "0745901TG4304N0003LJ",
"staircase": "",
"floor": "01",
"door": "C",
"use": "Residencial",
"area": 163,
"description": "Planta 01, Pta. C - Residencial",
"ownershipShare": 0.293879,
"yearBuilt": 2023,
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:C"
}
],
"truncated": true,
"nextCursor": "0745901TG4304N0201MZ",
"dataSource": "clone",
"dataDate": "2026-01-23",
"attribution": "Dirección General del Catastro"
},
"remainingSearches": 2893
}3. Espaces protégés : Natura 2000 et parcs
Avant d'acheter un terrain rural, il vaut mieux savoir s'il se trouve dans un espace protégé : cela limite ce que l'on peut construire ou planter. /terrain croise le contour de la parcelle avec le réseau Natura 2000 et les espaces protégés nationaux (CDDA) et indique quelle part de la parcelle se trouve à l'intérieur. Exemple réel : une parcelle entièrement située dans le parc national de Monfragüe.
curl "https://api.parcelgps.com/v1/parcels/10194A00110004/terrain?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Extrait de la réponse réelle
{
"success": true,
"data": {
"reference": "10194A00110004",
"country": "ES",
"protectedAreas": {
"status": "ok",
"intersects": true,
"inside": true,
"maxOverlapPct": 100,
"natura2000": [
{
"code": "ES0000014",
"name": "Monfragüe y las Dehesas del Entorno",
"type": "SPA",
"country": "ES",
"overlapPct": 100
},
{
"code": "ES4320077",
"name": "Monfragüe",
"type": "SCI",
"country": "ES",
"overlapPct": 100
}
],
"national": [
{
"code": "4820",
"name": "Monfragüe",
"designation": "National Park",
"country": "ES",
"overlapPct": 100
}
],
"method": "parcel",
"sources": [
{
"name": "Natura 2000",
"license": "CC BY 4.0",
"edition": "end 2024"
},
{
"name": "Nationally designated areas (CDDA)",
"license": "CC BY 4.0",
"edition": "2025"
}
]
}
}
}4. Le sol s'affaisse-t-il ?
/ground-motion fournit la vitesse verticale du sol mesurée par le radar Sentinel-1 (Copernicus EGMS, 2020-2024) sur la parcelle. Exemple réel : une parcelle à Murcie qui s'affaisse de 40,9 mm par an, classe severe_subsidence. Lorsque le satellite ne dispose d'aucun réflecteur (champs ouverts, forêt, eau), la réponse est status no_data plutôt qu'une estimation inventée.
curl "https://api.parcelgps.com/v1/parcels/30024A16000286/ground-motion?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Réponse réelle
{
"success": true,
"data": {
"reference": "30024A16000286",
"country": "ES",
"status": "ok",
"period": { "from": "2020-01", "to": "2024-12", "label": "2020-2024" },
"groundMotion": {
"class": "severe_subsidence",
"worstClass": "severe_subsidence",
"vertical": {
"meanMmYear": -40.9, "maxSubsidenceMmYear": -40.9, "maxUpliftMmYear": 0,
"stdMmYear": 0.1, "accelerationMmYear2": -0.7, "rmseMm": 2.3
},
"eastWest": { "meanMmYear": -5.1, "stdMmYear": 0.1 },
"yearlyDisplacement": [
{ "year": 2020, "mm": -17.9 }, { "year": 2021, "mm": -57.2 }, { "year": 2022, "mm": -95.8 },
{ "year": 2023, "mm": -141.8 }, { "year": 2024, "mm": -179.8 }
],
"cellsWithData": 1, "cellsConsidered": 1, "coveragePct": 100,
"basis": "parcel", "cellSizeM": 100
},
"source": {
"name": "European Ground Motion Service (EGMS) L3 Ortho",
"license": "Copernicus data policy (Regulation (EU) No 1159/2013): free, commercial use allowed with attribution",
"attribution": "Contains modified Copernicus Land Monitoring Service information, European Ground Motion Service 2020-2024 (© European Union, Copernicus Land Monitoring Service, EEA)",
"resolution": "100 m"
},
"calculatedAt": "2026-10-01T08:13:58Z",
"provenance": "2"
},
"remainingSearches": 4320
}