Documentacion API
Referencia completa de la API catastral
Base URL
https://api.parcelgps.comAutenticacion
Todas las peticiones a la API requieren una API key enviada en la cabecera X-API-Key.
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S"Obtiene tu API key gratuita en tu panel de desarrollador.
Codigos de error
| Status | Descripcion |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized (invalid or missing API key) |
| 404 | Not Found |
| 429 | Rate Limit Exceeded |
| 500 | Internal Server Error |
Spain (ES)
Spanish Cadastre — Direccion General del Catastro
/catastro/:refcatObtener datos de parcela por referencia catastral (14 o 20 caracteres).
Parametros
| :refcat | string | Cadastral reference (e.g. 9872023VH5797S0001WX) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S0001WX"Ejemplo de respuesta
{
"success": true,
"data": {
"refCatastral": "9872023VH5797S0001WX",
"pais": "ES",
"direccion": "CL GRAN VIA 1",
"codigoPostal": "28013",
"municipio": "MADRID",
"provincia": "MADRID",
"latitud": 40.4168,
"longitud": -3.7038,
"googleMapsUrl": "https://maps.google.com/?q=40.4168,-3.7038",
"uso": "Residencial",
"clase": "Urbana",
"superficieConstruida": 125,
"superficieParcela": 200,
"anioConstruccion": 1920,
"coefParticipacion": "12.50",
"poligono": [[-3.704, 40.416], [-3.703, 40.416], ...],
"availableFields": {
"uso": true, "clase": true, "anioConstruccion": true,
"superficieConstruida": true, "coefParticipacion": true,
"direccion": true, "busquedaDireccion": true
}
},
"searchesRemaining": 4
}/search/coordinatesGeocodificacion inversa: encontrar la parcela catastral en unas coordenadas GPS.
Parametros
| latitude | number | Latitude (WGS84) |
| longitude | number | Longitude (WGS84) |
| country | string | Country code (default: ES) |
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude": 40.4168, "longitude": -3.7038, "country": "ES"}' \
"https://api.parcelgps.com/search/coordinates"Ejemplo de respuesta
{
"success": true,
"data": {
"referenciaCatastral": "9872023VH5797S0001WX",
"refCat14": "9872023VH5797S",
"direccion": "CL GRAN VIA 1",
"municipio": "MADRID",
"tipoInmueble": "",
"coordenadas": { "latitud": 40.4168, "longitud": -3.7038 },
"googleMapsUrl": "https://maps.google.com/?q=40.4168,-3.7038"
},
"searchesRemaining": 3
}/search/address/parseBuscar parcela catastral por direccion postal.
Parametros
| direccion | string | Free-text address (Spain only) |
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"direccion": "Gran Via 1, Madrid"}' \
"https://api.parcelgps.com/search/address/parse"Ejemplo de respuesta
{
"success": true,
"data": {
"referenciaCatastral": "9872023VH5797S0001WX",
"direccion": "CL GRAN VIA 1",
"municipio": "MADRID",
"provincia": "MADRID"
},
"searchesRemaining": 2
}Portugal (PT)
Portuguese Cadastre — Direcao-Geral do Territorio
/catastro/:refcat?country=PTObtener datos de parcela portuguesa por referencia cadastral.
Parametros
| :refcat | string | Portuguese cadastral reference (NIP) |
| country | string | Must be "PT" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/U0512N0003200?country=PT"Ejemplo de respuesta
{
"success": true,
"data": {
"refCatastral": "U0512N0003200",
"pais": "PT",
"latitud": 38.7223,
"longitud": -9.1393,
"googleMapsUrl": "https://maps.google.com/?q=38.7223,-9.1393",
"municipio": "LISBOA",
"superficieParcela": 450,
"poligono": [[-9.14, 38.72], ...]
},
"searchesRemaining": 4
}France (FR)
French Cadastre — Cadastre / Geoplateforme
/catastro/:refcat?country=FRObtener datos de parcela francesa por referencia cadastrale.
Parametros
| :refcat | string | French cadastral reference (e.g. 750560000AB0001) |
| country | string | Must be "FR" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/750560000AB0001?country=FR"Ejemplo de respuesta
{
"success": true,
"data": {
"refCatastral": "750560000AB0001",
"pais": "FR",
"latitud": 48.8566,
"longitud": 2.3522,
"googleMapsUrl": "https://maps.google.com/?q=48.8566,2.3522",
"municipio": "PARIS",
"provincia": "Paris",
"superficieParcela": 320,
"poligono": [[2.35, 48.85], ...]
},
"searchesRemaining": 4
}Italy (IT)
Italian Cadastre — Agenzia delle Entrate
/catastro/:refcat?country=ITObtener datos de parcela italiana por referencia catastale.
Parametros
| :refcat | string | Italian cadastral reference |
| country | string | Must be "IT" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/A0420001?country=IT"Ejemplo de respuesta
{
"success": true,
"data": {
"refCatastral": "A0420001",
"pais": "IT",
"latitud": 41.9028,
"longitud": 12.4964,
"googleMapsUrl": "https://maps.google.com/?q=41.9028,12.4964",
"municipio": "ROMA",
"superficieParcela": 180,
"poligono": [[12.49, 41.90], ...]
},
"searchesRemaining": 4
}Germany (DE)
German Cadastre — ALKIS (8 Bundesländer)
/catastro/:refcat?country=DEObtener datos de parcela alemana (NRW) por referencia catastral.
Parametros
| :refcat | string | German cadastral reference (Flurstückskennzeichen) |
| country | string | Must be "DE" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/05315000200001?country=DE"Ejemplo de respuesta
{
"success": true,
"data": {
"refCatastral": "05315000200001",
"pais": "DE",
"latitud": 50.9375,
"longitud": 6.9603,
"googleMapsUrl": "https://maps.google.com/?q=50.9375,6.9603",
"municipio": "KÖLN",
"superficieParcela": 520,
"poligono": [[6.96, 50.93], ...]
},
"searchesRemaining": 4
}Polygon / Solar / Export
Endpoints adicionales (requieren plan Pro o superior).
/catastro/:refcat/polygonObtener el poligono GeoJSON de una parcela.
Parametros
| :refcat | string | Cadastral reference |
| country | string | Country code (query param, default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S/polygon"Ejemplo de respuesta
{
"success": true,
"data": {
"refCatastral": "9872023VH5797S",
"pais": "ES",
"latitud": 40.4168,
"longitud": -3.7038,
"poligono": [[-3.704, 40.416], [-3.703, 40.416], ...]
},
"searchesRemaining": 4
}/catastro/:refcat/solarObtener datos de potencial solar (PVGIS) de una parcela europea.
Parametros
| :refcat | string | Cadastral reference |
| country | string | Country code (query param, default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S/solar"Ejemplo de respuesta
{
"success": true,
"data": {
"kwh_year": 4200.0,
"kw_instalables": 3.5,
"ahorro_anual_eur": 680.0,
"amortizacion_anos": 8.5,
"co2_evitado_kg": 1890.0,
"irradiacion_media": 1650.5,
"nota_solar": 4,
"disponible": true,
"estado": "ok"
}
}/export/kml?refcat=:refcatExportar datos de parcela en formato KML (Google Earth).
Parametros
| refcat | string | Cadastral reference |
| country | string | Country code (default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/export/kml?refcat=9872023VH5797S" -o parcel.kmlEjemplo de respuesta
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Placemark>
<name>9872023VH5797S</name>
...
</Placemark>
</Document>
</kml>/export/gpx?refcat=:refcatExportar datos de parcela en formato GPX (navegadores GPS).
Parametros
| refcat | string | Cadastral reference |
| country | string | Country code (default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/export/gpx?refcat=9872023VH5797S" -o parcel.gpxEjemplo de respuesta
<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1">
<wpt lat="40.4168" lon="-3.7038">
<name>9872023VH5797S</name>
</wpt>
</gpx>