API Documentation

Complete cadastral API reference

Base URL

https://api.parcelgps.com

Códigos de país

Los endpoints aceptan ?country=XX. La España peninsular usa ES, pero País Vasco y Navarra tienen catastro propio (foral) y requieren su propio código — con ES sus parcelas no se encuentran.

ES · EspañaPV · País VascoNA · NavarraPT · PortugalFR · FranceIT · ItaliaDE · DeutschlandAT · Österreich

Endpoint reference

Método	Endpoint	Auth	Descripción
GET	/api/catastro/:refcat?country=XX	API Key	Parcel lookup
GET	/api/catastro/:refcat/polygon?country=XX	API Key	Parcel geometry (GeoJSON)
GET	/api/catastro/:refcat/solar?country=XX	API Key	Solar potential
GET	/api/catastro/:refcat/agro?country=XX	API Key	Agricultural land data
GET	/api/export/kml?refcat=X&country=X	API Key	Export KML/GPX/PDF/DXF
GET	/api/catastro/:refcat/market?country=XX	Web & app	Market data (not via API)
GET	/api/catastro/:refcat/score?country=XX	Web & app	Investment score (not via API)

Authentication

All API requests require an API key sent in the X-API-Key header.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S"

Get your free API key at your developer dashboard.

Error codes

Status	Code	Description
200	—	OK — La petición se ha completado correctamente.
400	VALIDATION_ERROR	Bad Request — Parámetros inválidos o referencia catastral con formato incorrecto.
401	UNAUTHORIZED	Unauthorized — API key inválida, expirada o no proporcionada.
404	NOT_FOUND	Not Found — No se encontró la parcela con la referencia o coordenadas indicadas.
429	KEY_AUTH_004	Quota Exceeded — Has alcanzado el límite mensual de tu plan. Comprueba las cabeceras `X-RateLimit-Remaining` y `X-RateLimit-Reset` para saber cuándo se reinicia.
429	RATE_LIMIT_EXCEEDED / DAILY_LIMIT_REACHED	Too Many Requests — Límite de búsquedas gratuitas por IP / día (tier gratuito). Con API key aplica la cuota mensual del plan (arriba).
500	INTERNAL_ERROR	Internal Server Error — Error en nuestro servidor. Si persiste, contacta soporte.
503	SERVICE_UNAVAILABLE	Service Unavailable — El servicio catastral externo del país consultado no está disponible temporalmente. Estos servicios son gestionados por organismos públicos (Catastro, DGT, Géoportail, Agenzia Entrate, ALKIS...) y están fuera de nuestro control. Reintenta en unos minutos.

Cabeceras de rate limit

Cada respuesta incluye cabeceras que indican el estado de tu quota:

Header	Description
X-RateLimit-Limit	Límite mensual total de tu plan (ej: 5000).
X-RateLimit-Remaining	Llamadas restantes este mes.
X-RateLimit-Reset	Fecha de reinicio de la quota (ISO 8601).
X-Quota-Tier	Nombre del tier actual (free, basic, pro, business).

Spain (ES)

Spanish Cadastre — Direccion General del Catastro

GET/api/catastro/:refcat

Get parcel data by cadastral reference (14 or 20 characters).

Parameters

:refcat

string

Cadastral reference (e.g. 9872023VH5797S0001WX)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S0001WX"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/9872023VH5797S0001WX",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/9872023VH5797S0001WX",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "9872023VH5797S0001WX",
    "direccion": "CL GLORIA 51",
    "codigoPostal": "13730",
    "municipio": "SANTA CRUZ DE MUDELA",
    "provincia": "CIUDAD REAL",
    "latitud": 38.640143,
    "longitud": -3.463284,
    "googleMapsUrl": "https://www.google.com/maps?q=38.640143,-3.463284",
    "uso": "Residencial",
    "clase": "Urbano",
    "superficieConstruida": 308,
    "superficieParcela": 397,
    "anioConstruccion": 1980,
    "coefParticipacion": "100",
    "poligono": [ /* geometría de la parcela */ ],
    "availableFields": {
      "uso": true, "clase": true, "anioConstruccion": true,
      "superficieConstruida": true, "coefParticipacion": true,
      "direccion": true, "busquedaDireccion": true
    }
  },
  "searchesRemaining": 4
}

Errores posibles

Code	HTTP	Description
VALIDATION_ERROR	400	La referencia no tiene un formato válido para el país.
NOT_FOUND	404	Referencia no encontrada. Un ?country no soportado se trata como España (ES) → normalmente NOT_FOUND; usa ES/PT/FR/IT/DE/PV/NA. En catastros forales (NA, PV) el message añade una pista de formato.
RATE_LIMIT_EXCEEDED / DAILY_LIMIT_REACHED	429	Límite de búsquedas gratuitas por IP / día.
KEY_AUTH_004	429	Cuota mensual de la API key agotada (ver cabeceras X-RateLimit-*).
SERVICE_UNAVAILABLE	503	El servicio catastral oficial del país está caído o en mantenimiento. Reintentar.

Try it live

POST/api/search/coordinates

Reverse geocode: find the cadastral parcel at given GPS coordinates.

Parameters

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/api/search/coordinates"

import requests

resp = requests.post(
    "https://api.parcelgps.com/api/search/coordinates",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"latitude": 40.4168, "longitude": -3.7038, "country": "ES"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/search/coordinates",
  {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ latitude: 40.4168, longitude: -3.7038, country: "ES" })
  }
);
const data = await res.json();

Response example

200 OK

{
  "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
}

Errores posibles

Code	HTTP	Description
VALIDATION_ERROR	400	Coordenadas fuera de los límites del país indicado/detectado, o lat/lng ausentes o mal formadas.
NOT_FOUND	404	No hay ninguna parcela en esas coordenadas.
RATE_LIMIT_EXCEEDED / DAILY_LIMIT_REACHED	429	Límite de búsquedas gratuitas por IP / día.
SERVICE_UNAVAILABLE	503	Servicio catastral no disponible temporalmente.

Try it live

POST/api/search/address/parse

Search cadastral parcel by postal address.

Parameters

direccion

string

Free-text address (Spain only). Recommended format: "Calle, Número, Municipio" — e.g. "Calle Mallorca, 213, Barcelona". The house number may also be attached to the street ("Gran Vía 1, Madrid").

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/api/search/address/parse"

import requests

resp = requests.post(
    "https://api.parcelgps.com/api/search/address/parse",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"direccion": "Gran Via 1, Madrid"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/search/address/parse",
  {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ direccion: "Gran Via 1, Madrid" })
  }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "referenciaCatastral": "0847106VK4704F",
    "refCat14": "0847106VK4704F",
    "direccion": "CL GRAN VIA, 1, Madrid",
    "tipoVia": "CL",
    "nombreVia": "GRAN VIA",
    "numero": 1,
    "municipio": "Madrid",
    "provincia": "MADRID"
  },
  "searchesRemaining": -1
}

Errores posibles

Code	HTTP	Description
VALIDATION_ERROR	400	Cuerpo de la petición inválido (faltan campos o JSON mal formado).
NOT_FOUND	404	Dirección no encontrada (calle/municipio/número inexistente o sin correspondencia catastral). La búsqueda por dirección está disponible solo en España.
RATE_LIMIT_EXCEEDED / DAILY_LIMIT_REACHED	429	Límite de búsquedas gratuitas por IP / día.

Try it live

País Vasco (PV)

Cadastros forales — Araba/Álava, Bizkaia y Gipuzkoa (WFS INSPIRE)

GET/api/catastro/:refcat?country=PV

Consulta de parcela en los tres territorios forales. Requiere country=PV: sus parcelas tienen catastro propio y no están en el Catastro central.

Parameters

:refcat	string	Referencia foral. Bizkaia con puntos (48.020.1611.02001); Álava y Gipuzkoa en dígitos (64010007, 8594149).
country	string	Obligatorio: "PV".

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/48.020.1611.02001?country=PV"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/48.020.1611.02001",
    params={"country": "PV"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/48.020.1611.02001?country=PV",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "48.020.1611.02001",
    "pais": "PV",
    "municipio": "Bizkaia",
    "provincia": "Bizkaia",
    "latitud": 43.263633,
    "longitud": -2.935856,
    "superficieParcela": 3061,
    "googleMapsUrl": "https://www.google.com/maps?q=43.263633,-2.935856",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Con country=ES (incorrecto)

404

{
  "success": false,
  "error": "Parcela no encontrado: 48.020.1611.02001",
  "code": "NOT_FOUND"
}

Try it live

Navarra (NA)

Catastro foral de Navarra — IDENA

GET/api/catastro/:refcat?country=NA

Consulta de parcela en Navarra. Requiere country=NA. La referencia usa el formato MUNICIPIO-POLÍGONO-PARCELA.

Parameters

:refcat	string	Formato MUNICIPIO-POLÍGONO-PARCELA (p. ej. 201-1-1339).
country	string	Obligatorio: "NA".

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/201-1-1339?country=NA"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/201-1-1339",
    params={"country": "NA"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/201-1-1339?country=NA",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "201-1-1339",
    "pais": "NA",
    "municipio": "PAMPLONA / IRUÑA",
    "provincia": "Navarra",
    "clase": "Urbana",
    "latitud": 42.816958,
    "longitud": -1.642812,
    "superficieParcela": 9591,
    "googleMapsUrl": "https://www.google.com/maps?q=42.816958,-1.642812",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Con country=ES (incorrecto)

400

{
  "success": false,
  "error": "La referencia catastral debe tener al menos 14 caracteres",
  "code": "VALIDATION_ERROR"
}

Try it live

Portugal (PT)

Portuguese Cadastre — Direcao-Geral do Territorio

GET/api/catastro/:refcat?country=PT

Get Portuguese parcel data by cadastral reference.

Parameters

:refcat	string	Portuguese cadastral reference (e.g. AAA000587359). Coverage is partial (~30%); areas like Lisbon and Porto are not yet digitized by the DGT.
country	string	Must be "PT"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/AAA000587359?country=PT"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/AAA000587359",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"country": "PT"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/AAA000587359?country=PT",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "AAA000587359",
    "pais": "PT",
    "municipio": "TAVIRA, Tavira (Santa Maria e Santiago)",
    "latitud": 37.127156,
    "longitud": -7.648066,
    "superficieParcela": 49,
    "googleMapsUrl": "https://www.google.com/maps?q=37.127156,-7.648066",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Try it live

France (FR)

French Cadastre — Cadastre / Geoplateforme

GET/api/catastro/:refcat?country=FR

Get French parcel data by cadastral reference.

Parameters

:refcat	string	French cadastral reference (e.g. 75104000AE0003)
country	string	Must be "FR"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/75104000AE0003?country=FR"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/75104000AE0003",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"country": "FR"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/75104000AE0003?country=FR",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "75104000AE0003",
    "pais": "FR",
    "municipio": "Paris",
    "provincia": "75",
    "latitud": 48.856347,
    "longitud": 2.352415,
    "superficieParcela": 15168,
    "googleMapsUrl": "https://www.google.com/maps?q=48.856347,2.352415",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Try it live

Italy (IT)

Italian Cadastre — Agenzia delle Entrate

GET/api/catastro/:refcat?country=IT

Get Italian parcel data by cadastral reference.

Parameters

:refcat	string	Italian cadastral reference (foglio/particella, e.g. H501A048100.A)
country	string	Must be "IT"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/H501A048100.A?country=IT"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/H501A048100.A",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"country": "IT"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/H501A048100.A?country=IT",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "H501A048100.A",
    "pais": "IT",
    "municipio": "H501",
    "provincia": "H501",
    "latitud": 41.902698,
    "longitud": 12.496247,
    "superficieParcela": 1059,
    "googleMapsUrl": "https://www.google.com/maps?q=41.902698,12.496247",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Try it live

Germany (DE)

German Cadastre — ALKIS (8 Bundesländer)

GET/api/catastro/:refcat?country=DE

Get German parcel data by cadastral reference.

Parameters

:refcat	string	German cadastral reference (Flurstückskennzeichen)
country	string	Must be "DE"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/05495803101122?country=DE"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/05495803101122",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"country": "DE"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/05495803101122?country=DE",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "05495803101122",
    "pais": "DE",
    "latitud": 50.937566,
    "longitud": 6.960140,
    "superficieParcela": 54,
    "googleMapsUrl": "https://www.google.com/maps?q=50.937566,6.960140",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Try it live

Austria (AT)

Österreichisches Kataster — BEV (Katastralgemeinde / Grundstück)

GET/api/catastro/:refcat?country=AT

Consulta de parcela en Austria. Requiere country=AT. La referencia es KATASTRALGEMEINDE-GRUNDSTÜCK. Cobertura parcial, en expansión.

Parameters

:refcat	string	Formato Katastralgemeinde-Grundstück (p. ej. 01004-1711).
country	string	Obligatorio: "AT".

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/01004-1711?country=AT"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/01004-1711",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"country": "AT"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/01004-1711?country=AT",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "refCatastral": "01004-1711",
    "pais": "AT",
    "municipio": "Innere Stadt",
    "provincia": "Wien",
    "latitud": 48.208478,
    "longitud": 16.372810,
    "uso": "Gebäude, Straßenverkehrsanlagen",
    "superficieParcela": 10641,
    "googleMapsUrl": "https://www.google.com/maps?q=48.208478,16.372810",
    "poligono": [ /* geometría de la parcela */ ]
  }
}

Con country=ES (incorrecto)

400

{
  "success": false,
  "error": "La referencia catastral debe tener al menos 14 caracteres",
  "code": "VALIDATION_ERROR"
}

Try it live

Parcel intelligence & exports

Geometry, solar potential, agricultural data and file exports (KML/GPX/PDF/DXF), available with your API key. Market data and the investment score stay in the web app and app (Pro) and are not exposed via the API.

GET/api/catastro/:refcat/polygon

Get the GeoJSON polygon of a parcel.

Parameters

:refcat	string	Cadastral reference
country	string	Country code (query param, default: ES)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S/polygon"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/9872023VH5797S/polygon",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/9872023VH5797S/polygon",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "data": {
    "refcat": "9872023VH5797S",
    "geojson": {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [ [ [-3.463391, 38.640317], [-3.463174, 38.640217], /* ... */ ] ]
      }
    }
  }
}

Cuota mensual agotada

429

{
  "success": false,
  "error": "Cuota mensual agotada (5000/5000). Upgrade en https://catastrogps.es/developers",
  "code": "KEY_AUTH_004"
}

Try it live

GET/api/catastro/:refcat/solar

Get solar potential data (PVGIS) for any European parcel.

Parameters

:refcat	string	Cadastral reference
country	string	Country code (query param, default: ES)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S/solar"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/9872023VH5797S/solar",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/9872023VH5797S/solar",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "kwh_year": 23749.9,
    "kw_instalables": 17.86,
    "ahorro_anual_eur": 3562.49,
    "amortizacion_anos": 5,
    "co2_evitado_kg": 5533.73,
    "irradiacion_media": 1807.08,
    "nota_solar": 5,
    "orientacion_optima": "Sur",
    "angulo_inclinacion": 34,
    "costo_instalacion_eur": 17865,
    "disponible": true,
    "estado": "ok",
    "fuente": "PVGIS (JRC)",
    "economics": {
      "autoconsumo_kwh_ano": 5000,
      "excedentes_kwh_ano": 18749.9,
      "ingreso_neto_anual_eur": 1473.18,
      "payback_anos": 12.13,
      "tir_pct": 6.56,
      "retorno_total_25_anos_eur": 18964.5
    }
  }
}

Parcela sin datos solares

200

{
  "success": true,
  "data": { "disponible": false, "estado": "sin_datos" }
}

Try it live

GET/api/catastro/:refcat/agro

Agricultural land data for a parcel (SIGPAC): main crop, land use, slope, altitude and area. Rural parcels only — urban parcels return "cultivo_principal": "urbano".

Parameters

:refcat	string	Cadastral reference
country	string	Country code (query param, default: ES)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/catastro/23058A00700036/agro"

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/catastro/23058A00700036/agro",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(resp.json())

const res = await fetch(
  "https://api.parcelgps.com/api/catastro/23058A00700036/agro",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await res.json();

Response example

200 OK

{
  "success": true,
  "data": {
    "agro": {
      "cultivo_principal": "olivar",
      "uso_suelo": "Asociación olivar - viñedo",
      "superficie_ha": 10.6045,
      "coef_regadio": 1,
      "ndvi": {
        "valor_medio": 0.18,
        "salud_cultivo": "bajo",
        "ultima_actualizacion": "2026-06-18T00:00:00Z"
      },
      "precios_mercado": {
        "precio_kg": 8.5,
        "tendencia": "+12.5% vs periodo anterior"
      },
      "recinto": {
        "provincia": 23,
        "municipio": 58,
        "poligono": 7,
        "parcela": 36,
        "recinto": 1,
        "altitud": 559,
        "pendiente_media": 12.3
      }
    }
  }
}

Cuota mensual agotada

429

{
  "success": false,
  "error": "Cuota mensual agotada (5000/5000). Upgrade en https://catastrogps.es/developers",
  "code": "KEY_AUTH_004"
}

Try it live

GET/api/export/kml?refcat=:refcat

Export parcel data in KML format (Google Earth).

Parameters

refcat	string	Cadastral reference
country	string	Country code (default: ES)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/export/kml?refcat=9872023VH5797S" -o parcel.kml

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/export/kml",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"refcat": "9872023VH5797S"}
)
with open("parcel.kml", "wb") as f:
    f.write(resp.content)

const res = await fetch(
  "https://api.parcelgps.com/api/export/kml?refcat=9872023VH5797S",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const blob = await res.blob();

Response example

200 OK

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <Placemark>
      <name>9872023VH5797S</name>
      ...
    </Placemark>
  </Document>
</kml>

Try it live

GET/api/export/gpx?refcat=:refcat

Export parcel data in GPX format (GPS navigators).

Parameters

refcat	string	Cadastral reference
country	string	Country code (default: ES)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/api/export/gpx?refcat=9872023VH5797S" -o parcel.gpx

import requests

resp = requests.get(
    "https://api.parcelgps.com/api/export/gpx",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"refcat": "9872023VH5797S"}
)
with open("parcel.gpx", "wb") as f:
    f.write(resp.content)

const res = await fetch(
  "https://api.parcelgps.com/api/export/gpx?refcat=9872023VH5797S",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const blob = await res.blob();

Response example

200 OK

<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1">
  <wpt lat="40.4168" lon="-3.7038">
    <name>9872023VH5797S</name>
  </wpt>
</gpx>

Try it live