Spain Cadastre Scraper — Bulk Catastro Property Lookup

Bulk-enrich Spanish properties with official Catastro data — the Spanish cadastre — from a list of referencias catastrales (cadastral references) or postal addresses. This Catastro scraper returns land use, built surface area in m², construction year, normalized address and, for rural parcels, the crop/land-use breakdown. Source: the public OVC (Oficina Virtual del Catastro) service of the Dirección General del Catastro.

Enriquece listas de referencias catastrales (o de direcciones postales) con la ficha oficial del Catastro español: consulta catastral masiva con uso, superficie construida y año de construcción, dirección normalizada y, en fincas rústicas, cultivo y aprovechamiento. Sin titularidad: el servicio usado no publica nombre ni NIF del propietario.

Catastro scraper: what this bulk property lookup does · Qué hace

Es un enricher puro: tú aportas la referencia catastral (o la dirección) y recibes los atributos físicos del inmueble, uno por ítem. No es un buscador de propiedades ni un listado del mercado: es la ficha oficial del Catastro en JSON, a escala de miles de referencias por ejecución.

You provide the reference, you get the property's physical attributes back — one item per reference, at a scale of thousands per run.

Cadastral data extracted: fields per property · Qué datos extrae del Catastro

Un ítem por referencia catastral / one item per cadastral reference:

Campo / Field	Qué es / What it is
referenciaEntrada / referenciaCatastral	Lo que escribiste vs. la referencia oficial de 20 posiciones · Input vs. official 20-char reference
encontrado	true/false — si la referencia se pudo resolver · Whether it resolved
error	Motivo descriptivo cuando encontrado es false (nunca un ítem vacío en silencio) · Descriptive error
naturaleza	urbana o rustica · Urban or rural
usoPrincipal	Residencial, Comercial, Oficinas, Industrial, Agrario… · Main land use
superficieConstruidaM2	Superficie construida, en m² · Built surface
superficieSueloM2	Superficie de suelo/parcela, en m² · Plot surface
anoConstruccion	Año de construcción (solo urbana) · Construction year (urban only)
coeficienteParticipacion	% de participación en la finca (solo urbana con división horizontal) · Ownership share
divisionHorizontal	true si el inmueble es una unidad dentro de un edificio con varios inmuebles registrales, false si es una parcela sin dividir, null si no aplica (rústica)
direccion / direccionNormalizada	Vía, número, planta, puerta, municipio, provincia, CP — o polígono/parcela/paraje en rústica · Normalized address
construcciones	Desglose de construcciones dentro del inmueble (vivienda, garaje, trastero…) con su superficie · Building breakdown
subparcelasRusticas	En rústica: cultivo/aprovechamiento y superficie de cada subparcela · Rural crop breakdown
urlCartografia, urlSedeCatastro	Enlaces oficiales a la cartografía y a la ficha pública · Official map and record links

Nunca se devuelve titularidad: el endpoint de origen (Consulta_DNPRC, "Datos No Protegidos") no incluye nombre ni NIF del propietario por diseño. Es la fuente con menor riesgo legal de todo el lote (ver aviso legal más abajo). No ownership data is ever returned: the endpoint used (Consulta_DNPRC, "unprotected data") does not include the owner's name or tax ID by design.

Catastro lookup input: references, addresses and errors · Parámetros de entrada

Parámetro / Field	Tipo / Type	Por defecto / Default	Descripción / Notes
modo	referencias | direccion	referencias	Qué tipo de entrada se usa · Input type
referencias	lista de textos	[]	Referencias catastrales (modo referencias) · Cadastral references
direcciones	lista de objetos	[]	{provincia, municipio, via, numero, tipoVia} (modo direccion) · Address objects
maxItems	entero	500	Tope de ítems (incluidos los de error); el actor para limpiamente al alcanzarlo · Hard cap

Modos de entrada · Input modes

• referencias (modo principal): lista de referencias catastrales de 20 posiciones (p. ej. 6372226VK4767A0001GP). Una petición por referencia.
• direccion: lista de direcciones

  {provincia, municipio, via, numero, tipoVia}
  . El actor resuelve primero qué referencia(s) hay en esa dirección (una si es una parcela sin dividir, varias si el edificio tiene división horizontal — p. ej. un portal con 18 pisos y locales) y luego enriquece cada una igual que en modo referencias. Cuesta una petición extra por dirección.

{
  "modo": "referencias",
  "referencias": ["6372226VK4767A0001GP", "45203A001000010000LQ"],
  "maxItems": 500
}

{
  "modo": "direccion",
  "direcciones": [
    { "provincia": "MADRID", "municipio": "MADRID", "tipoVia": "CL", "via": "GRAN VIA", "numero": "1" }
  ],
  "maxItems": 500
}

Referencias inválidas o no encontradas · Invalid or not-found references

El servicio del Catastro devuelve HTTP 200 incluso en error (verificado en fase 0 y reconfirmado): el estado real va en un campo interno del JSON, no en el código HTTP. Este actor comprueba siempre ese campo, nunca el código HTTP, y cada referencia que falla genera un ítem propio con encontrado: false y un error descriptivo tomado directamente del mensaje oficial del Catastro (p. ej. "LA REFERENCIA CATASTRAL NO ESTÁ CORRECTAMENTE FORMADA" o "EL MUNICIPIO NO EXISTE."). Si subes 10.000 referencias, sabrás exactamente cuáles fallaron y por qué — nunca desaparecen en silencio.

Upload 10,000 references and you will know exactly which ones failed and why — nothing is silently dropped.

Catastro output example: real items from a real run · Ejemplo de output real

Dos ítems reales del dataset, copiados tal cual de una ejecución en modo referencias (registros 1 y 2 de 24): uno urbano y uno rústico. Two real dataset items, copied verbatim from a live run — one urban, one rural:

{
  "tipoRegistro": "inmueble",
  "referenciaEntrada": "6372226VK4767A0001GP",
  "referenciaCatastral": "6372226VK4767A0001GP",
  "encontrado": true,
  "error": null,
  "naturaleza": "urbana",
  "tipoFinca": "Parcela construida sin división horizontal",
  "divisionHorizontal": false,
  "usoPrincipal": "Residencial",
  "superficieConstruidaM2": 260,
  "superficieSueloM2": 154,
  "coeficienteParticipacion": 100,
  "anoConstruccion": 1998,
  "direccion": {
    "via": "CL RIOBAMBA",
    "numero": "50",
    "planta": "OD",
    "puerta": "OS",
    "codigoPostal": "28027",
    "municipio": "MADRID",
    "provincia": "MADRID",
    "poligono": null,
    "parcela": null,
    "paraje": null
  },
  "direccionNormalizada": "CL RIOBAMBA 50 28027 MADRID (MADRID)",
  "construcciones": [
    { "uso": "APARCAMIENTO", "tipo": "ANEJOS DE VIVIENDA Y LOCALES EN ESTRUCTURA", "superficieM2": 3, "planta": "-1", "puerta": "01" },
    { "uso": "APARCAMIENTO", "tipo": "ANEJOS DE VIVIENDA Y LOCALES EN ESTRUCTURA", "superficieM2": 69, "planta": "-1", "puerta": "02" },
    { "uso": "ALMACEN", "tipo": "ANEJOS DE VIVIENDA Y LOCALES EN ESTRUCTURA", "superficieM2": 17, "planta": "-1", "puerta": "03" },
    { "uso": "VIVIENDA", "tipo": "VIVIENDA UNIFAMILIAR", "superficieM2": 71, "planta": "00", "puerta": "01" },
    { "uso": "PORCHE 100%", "tipo": "ANEJOS DE VIVIENDA Y LOCALES EN ESTRUCTURA", "superficieM2": 2, "planta": "00", "puerta": "02" },
    { "uso": "VIVIENDA", "tipo": "VIVIENDA UNIFAMILIAR", "superficieM2": 75, "planta": "01", "puerta": "01" },
    { "uso": "ALMACEN", "tipo": "ANEJOS DE VIVIENDA Y LOCALES EN ESTRUCTURA", "superficieM2": 23, "planta": "02", "puerta": "01" }
  ],
  "subparcelasRusticas": [],
  "urlCartografia": "https://www1.sedecatastro.gob.es/Cartografia/mapa.aspx?del=28&mun=900&refcat=6372226VK4767A",
  "urlSedeCatastro": "https://www1.sedecatastro.gob.es/CYCBienInmueble/OVCConCiud.aspx?RefC=6372226VK4767A0001GP",
  "fuente": "Catastro - Sede Electronica, Direccion General del Catastro (servicio OVC, datos no protegidos)",
  "extraidoEn": "2026-08-23T15:50:16.708Z"
}

{
  "tipoRegistro": "inmueble",
  "referenciaEntrada": "45203A001000010000LQ",
  "referenciaCatastral": "45203A001000010000LQ",
  "encontrado": true,
  "error": null,
  "naturaleza": "rustica",
  "tipoFinca": null,
  "divisionHorizontal": null,
  "usoPrincipal": "Agrario",
  "superficieConstruidaM2": 0,
  "superficieSueloM2": 101654,
  "coeficienteParticipacion": null,
  "anoConstruccion": null,
  "direccion": {
    "via": null,
    "numero": null,
    "planta": null,
    "puerta": null,
    "codigoPostal": null,
    "municipio": "YEPES",
    "provincia": "TOLEDO",
    "poligono": "1",
    "parcela": "1",
    "paraje": "CUARTILLEJO"
  },
  "direccionNormalizada": "Polígono 1 Parcela 1 CUARTILLEJO. YEPES (TOLEDO)",
  "construcciones": [],
  "subparcelasRusticas": [
    { "id": "0", "cultivo": "LABOR O LABRADÍO SECANO", "codigoCultivo": "C-", "intensidadProductiva": "02", "superficieM2": 101654 }
  ],
  "urlCartografia": "https://www1.sedecatastro.gob.es/Cartografia/mapa.aspx?del=45&mun=203&refcat=45203A00100001",
  "urlSedeCatastro": "https://www1.sedecatastro.gob.es/CYCBienInmueble/OVCConCiud.aspx?RefC=45203A001000010000LQ",
  "fuente": "Catastro - Sede Electronica, Direccion General del Catastro (servicio OVC, datos no protegidos)",
  "extraidoEn": "2026-08-23T15:50:17.429Z"
}

Spain property data use cases · Casos de uso

Proptech y valoración · Real estate data Spain

Enriquecer una cartera de inmuebles con superficie construida, año de construcción y uso — los tres atributos que más pesan en una valoración automatizada.

Due diligence inmobiliaria · Property due diligence

Verificar contra la fuente oficial la superficie y el uso declarados de cada finca de una operación, con enlace directo a la ficha del Catastro.

Agro y fincas rústicas · Rural land data

Cultivo, aprovechamiento e intensidad productiva por subparcela, con la superficie de cada una.

Enriquecimiento de bases de datos · Bulk address enrichment

Convertir direcciones postales en referencias catastrales y ficha completa, resolviendo por el camino los edificios con división horizontal.

Catastro coverage, limits and run time · Cobertura, limitaciones y cuánto tarda

• Cubre el territorio de régimen común (~78 millones de inmuebles). No cubre País Vasco ni Navarra, que tienen catastro foral propio y no responden por este servicio. Does not cover the Basque Country or Navarre.
• No hay coordenadas geográficas en esta versión: se investigó el servicio hermano de coordenadas por referencia catastral (OVCCoordenadas.svc, Consulta_CPMRC) y devuelve de forma consistente una página de error HTML con HTTP 200 para las combinaciones de parámetros probadas — no es una fuente fiable ni verificada, y añadirla duplicaría el número de peticiones por ítem. Si en el futuro se localiza la forma correcta de consultarlo, es candidato directo para v0.2. Sí se incluye urlCartografia, el enlace oficial al visor de mapas del Catastro para esa parcela.
• El campo divisionHorizontal se deriva del texto oficial finca.ltp ("Parcela con varios inmuebles (division horizontal)" vs. "Parcela construida sin división horizontal"); en fincas rústicas ese campo no existe en el origen y el valor queda en null.
• El actor respeta un máximo de ~1 petición por segundo contra el servicio oficial: 1 petición por referencia en modo referencias, o 1 petición extra por dirección más 1 por cada referencia que resuelva en modo direccion. Rate-limited to ~1 request/second, with exponential-backoff retries.

Related Spanish public-data Actors · Actores relacionados

Actor	Qué extrae / What it scrapes
spain-borme-companies	BORME: constituciones con domicilio social, nombramientos y concursos
spain-boe-monitor	BOE: monitor incremental por palabra clave, sección y NIF
spain-grants-bdns	BDNS: convocatorias y concesiones de subvenciones públicas
spain-de-minimis-aid	BDNS: ayudas de minimis y ayudas de Estado por NIF
spain-grants-registries	BDNS: grandes beneficiarios, sanciones por fraude y partidos políticos
spain-bocm-gazette	BOCM: boletín oficial de la Comunidad de Madrid, en modo delta
spain-boja-gazette	BOJA: boletín oficial de la Junta de Andalucía, en modo delta
catalonia-tenders	Licitaciones y adjudicaciones públicas de Cataluña (PSCP)
euskadi-tenders	Anuncios de contratación pública del País Vasco
aragon-tenders	Registro de contratos públicos de Aragón (CKAN)

Is it legal? Catastro data, ownership and GDPR · Fuente y aviso legal

• Fuente oficial: servicio OVC (Oficina Virtual del Catastro) de la Dirección General del Catastro, Ministerio de Hacienda — https://ovc.catastro.meh.es/.
• Servicio anónimo, sin login, sin cookies, sin token. robots.txt no existe en este host (devuelve una página HTML genérica, sin Disallow alguno).
• El endpoint usado (Consulta_DNPRC, "Datos No Protegidos") no incluye titularidad: es información catastral no protegida, de consulta libre y gratuita, reutilizable conforme a la Ley 37/2007 de reutilización de la información del sector público. La información protegida (titularidad, valor catastral) requiere autenticación y este actor no la consulta ni la ofrece. Reuse is subject to Spanish law on the re-use of public sector information (Law 37/2007).
• ⚠️ Aunque el servicio no devuelve nombre ni NIF, una referencia catastral puede llegar a ser un dato personal indirecto si se asocia a una persona identificada por otra vía. Este actor es un enricher puro: tú aportas la referencia y recibes atributos físicos del inmueble. No cruces el resultado con datos de personas sin una base legal (RGPD / LOPDGDD) para hacerlo.
• Este actor solo lee datos públicos, con un User-Agent identificado y un ritmo de ~1 petición/segundo, sin saltarse ninguna medida técnica. No es un producto oficial ni está afiliado, respaldado ni verificado por la Dirección General del Catastro. Not an official product and not affiliated with or endorsed by it.
• Los datos son dinámicos (altas y modificaciones catastrales continuas): para decisiones con efectos jurídicos, consulta siempre la ficha oficial (urlSedeCatastro). For legally binding decisions, always check the official record.

Catastro scraper FAQ · Preguntas frecuentes

¿Puedo consultar miles de referencias catastrales de golpe?

Sí: es el caso de uso principal. Sube la lista en referencias y ajusta maxItems. El ritmo es de ~1 petición por segundo y por referencia.

¿Devuelve el propietario o el valor catastral? · Does it return the owner?

No, y no es una limitación del actor: el endpoint de datos no protegidos no incluye titularidad ni valor catastral por diseño. Esa información requiere autenticación y este actor no la consulta.

¿Puedo buscar por dirección en vez de por referencia?

Sí, con modo: "direccion". Si el edificio tiene división horizontal, la dirección devuelve varias referencias y el actor las enriquece todas.

¿Qué pasa con una referencia mal formada o inexistente?

Genera su propio ítem con encontrado: false y el mensaje de error oficial del Catastro. Nunca se descarta en silencio.

¿Cubre el País Vasco y Navarra? · Does it cover the Basque Country?

No: ambos tienen catastro foral propio y no responden por este servicio. El resto del territorio de régimen común sí, ~78 millones de inmuebles.

¿Trae coordenadas geográficas? · Are coordinates included?

No en esta versión, por la razón explicada en las limitaciones. Sí se incluye urlCartografia, el enlace al visor de mapas oficial de esa parcela.

¿Cuánto cuesta ejecutarlo? · How much does it cost?

El modelo de precio aparece en la pestaña Pricing de esta misma ficha del Store. En consumo, el modo direccion cuesta una petición más por dirección que el modo referencias.

Support and feedback · Soporte y sugerencias

¿Necesitas otro campo del Catastro, otro modo de entrada o una integración a medida? Abre un issue desde la pestaña Issues de esta ficha.

Need another Catastro field, another input mode or a custom integration? Open an issue from the Issues tab.

Palabras clave / Keywords: Catastro scraper, Spanish cadastre API, referencia catastral consulta, Spain property data API, consulta catastral masiva, superficie construida y año de construcción, real estate data Spain, cadastral reference lookup, Catastro OVC, datos catastrales por dirección, property enrichment Spain, fincas rústicas cultivo, Sede Electrónica del Catastro, proptech, due diligence inmobiliaria.