Catastro GPSCatastro GPS

Documentacion API

Referencia completa de la API catastral

Base URL

https://api.parcelgps.com

Autenticacion

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

StatusDescripcion
200OK
400Bad Request
401Unauthorized (invalid or missing API key)
404Not Found
429Rate Limit Exceeded
500Internal Server Error

Spain (ES)

Spanish Cadastre — Direccion General del Catastro

GET/catastro/:refcat

Obtener datos de parcela por referencia catastral (14 o 20 caracteres).

Parametros

:refcatstringCadastral 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
}
POST/search/coordinates

Geocodificacion inversa: encontrar la parcela catastral en unas coordenadas GPS.

Parametros

latitudenumberLatitude (WGS84)
longitudenumberLongitude (WGS84)
countrystringCountry 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
}
POST/search/address/parse

Buscar parcela catastral por direccion postal.

Parametros

direccionstringFree-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

GET/catastro/:refcat?country=PT

Obtener datos de parcela portuguesa por referencia cadastral.

Parametros

:refcatstringPortuguese cadastral reference (NIP)
countrystringMust 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

GET/catastro/:refcat?country=FR

Obtener datos de parcela francesa por referencia cadastrale.

Parametros

:refcatstringFrench cadastral reference (e.g. 750560000AB0001)
countrystringMust 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

GET/catastro/:refcat?country=IT

Obtener datos de parcela italiana por referencia catastale.

Parametros

:refcatstringItalian cadastral reference
countrystringMust 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)

GET/catastro/:refcat?country=DE

Obtener datos de parcela alemana (NRW) por referencia catastral.

Parametros

:refcatstringGerman cadastral reference (Flurstückskennzeichen)
countrystringMust 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).

GET/catastro/:refcat/polygon

Obtener el poligono GeoJSON de una parcela.

Parametros

:refcatstringCadastral reference
countrystringCountry 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
}
GET/catastro/:refcat/solar

Obtener datos de potencial solar (PVGIS) de una parcela europea.

Parametros

:refcatstringCadastral reference
countrystringCountry 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"
  }
}
GET/export/kml?refcat=:refcat

Exportar datos de parcela en formato KML (Google Earth).

Parametros

refcatstringCadastral reference
countrystringCountry code (default: ES)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/export/kml?refcat=9872023VH5797S" -o parcel.kml

Ejemplo 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>
GET/export/gpx?refcat=:refcat

Exportar datos de parcela en formato GPX (navegadores GPS).

Parametros

refcatstringCadastral reference
countrystringCountry code (default: ES)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/export/gpx?refcat=9872023VH5797S" -o parcel.gpx

Ejemplo 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>