Comprobar una finca antes de comprarla
De la dirección del anuncio a lo que dice el Catastro y lo que se ve desde el satélite: qué finca es, qué hay dentro, si cae en un espacio protegido y si el terreno se mueve. Cada paso usa una finca distinta para enseñar un caso con datos; en tu flujo es la misma referencia de principio a fin.
Países: ES
1. De la dirección a la finca
La dirección en texto libre devuelve candidatos ordenados por confianza (0 a 1) con la referencia de 14 caracteres, el uso, las viviendas y el año. Por encima de 0,75 coinciden número y municipio. Cuesta 1 unidad solo si hay candidatos.
curl -G "https://api.parcelgps.com/api/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"Respuesta real
{
"success": true,
"data": {
"consulta": {
"texto": "Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas",
"calle": "Avenida José Rodríguez de la Borbolla Camoyán",
"numero": 10,
"municipio": "Dos Hermanas"
},
"candidatos": [
{
"refCatastral": "0745901TG4304N",
"pais": "ES",
"direccion": "AVENIDA JOSE RGUEZ BORBOLLA CAMOY 10",
"numero": 10,
"codigoPostal": "41704",
"municipio": "Dos Hermanas",
"provincia": "Sevilla",
"latitud": 37.31947088654626,
"longitud": -5.926788955974699,
"confianza": 0.93,
"coincideNumero": true,
"coincideMunicipio": true,
"enCopia": true,
"direccionCatastro": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"uso": "Residencial",
"viviendas": 346,
"anioConstruccion": 2023
},
{
"refCatastral": "0747201TG4304N",
"pais": "ES",
"direccion": "BULEVAR JOSE RODRIGUEZ DE LA BORBOLLA CAMOYAN 11",
"numero": 11,
"confianza": 0.55,
"coincideNumero": false,
"coincideMunicipio": true,
"enCopia": true
}
],
"attribution": "CartoCiudad (Instituto Geográfico Nacional) y Dirección General del Catastro"
}
}2. Qué hay dentro: viviendas, locales y anejos
Con la referencia de 14 caracteres salen todas las unidades de la finca con uso, superficie, planta, puerta y coeficiente de participación. Sirve para comprobar que la superficie y el uso del anuncio coinciden con el Catastro. Cuesta 1 unidad por unidad servida.
curl "https://api.parcelgps.com/api/catastro/0745901TG4304N/units" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Respuesta real
HTTP/2 200
etag: "5ab6bd3d95f85dddba81818bcb0cb65e"
cache-control: private, max-age=21600
x-quota-remaining: 2893
{
"success": true,
"data": {
"refCatastral": "0745901TG4304N",
"direccion": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"codigoPostal": "41704",
"municipio": "DOS HERMANAS",
"provincia": "Sevilla",
"usoGeneral": "Residencial",
"superficieTotal": 32789,
"anioConstruccion": 2023,
"totalUnidades": 200,
"totalUnidadesFinca": 365,
"unidades": [
{
"refCatastral": "0745901TG4304N0002KH",
"escalera": "",
"planta": "01",
"puerta": "B",
"uso": "Residencial",
"superficie": 155,
"descripcion": "Planta 01, Pta. B - Residencial",
"participacion": 0.279543,
"anio": 2023,
"direccion": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:B"
},
{
"refCatastral": "0745901TG4304N0003LJ",
"escalera": "",
"planta": "01",
"puerta": "C",
"uso": "Residencial",
"superficie": 163,
"descripcion": "Planta 01, Pta. C - Residencial",
"participacion": 0.293879,
"anio": 2023,
"direccion": "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"
},
"searchesRemaining": -1
}3. Espacios protegidos: Natura 2000 y parques
Antes de comprar suelo rústico conviene saber si cae dentro de un espacio protegido: limita lo que se puede construir o plantar. /terrain cruza el contorno de la parcela con Natura 2000 y los espacios nacionales (CDDA) y dice qué parte de la parcela queda dentro. Ejemplo real: una parcela entera dentro del Parque Nacional de Monfragüe.
curl "https://api.parcelgps.com/api/catastro/10194A00110004/terrain?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Respuesta real, recortada
{
"success": true,
"data": {
"refcat": "10194A00110004",
"country": "ES",
"protected_areas": {
"status": "ok",
"intersects": true,
"inside": true,
"max_overlap_pct": 100,
"natura2000": [
{
"code": "ES0000014",
"name": "Monfragüe y las Dehesas del Entorno",
"type": "SPA",
"country": "ES",
"overlap_pct": 100
},
{
"code": "ES4320077",
"name": "Monfragüe",
"type": "SCI",
"country": "ES",
"overlap_pct": 100
}
],
"national": [
{
"code": "4820",
"name": "Monfragüe",
"designation": "National Park",
"country": "ES",
"overlap_pct": 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. Si el terreno se hunde
/ground-motion da la velocidad vertical del terreno medida por el radar de Sentinel-1 (Copernicus EGMS, 2020-2024) sobre la parcela. Ejemplo real: una parcela de Murcia que baja 40,9 mm al año, clase severe_subsidence. Si el satélite no tiene reflectores (campo abierto, bosque, agua), responde status no_data en vez de inventar.
curl "https://api.parcelgps.com/api/catastro/30024A16000286/ground-motion?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Respuesta real
{
"success": true,
"data": {
"refcat": "30024A16000286",
"country": "ES",
"status": "ok",
"period": { "from": "2020-01", "to": "2024-12", "label": "2020-2024" },
"ground_motion": {
"class": "severe_subsidence",
"worst_class": "severe_subsidence",
"vertical": {
"mean_mm_year": -40.9, "max_subsidence_mm_year": -40.9, "max_uplift_mm_year": 0,
"std_mm_year": 0.1, "acceleration_mm_year2": -0.7, "rmse_mm": 2.3
},
"east_west": { "mean_mm_year": -5.1, "std_mm_year": 0.1 },
"yearly_displacement": [
{ "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 }
],
"cells_with_data": 1, "cells_considered": 1, "coverage_pct": 100,
"basis": "parcel", "cell_size_m": 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"
},
"calculated_at": "2026-10-01T06:14:34Z",
"provenance": "1"
}
}