Catastro España — inmuebles por referencia catastral o dirección

Consulta oficial de la Sede Electrónica del Catastro (servicios OVC, datos abiertos sin clave): cualquier inmueble de España, con su uso, superficie construida, coeficiente de participación, año de construcción, escalera/planta/puerta, código postal y desglose de construcciones por planta.

Familia España — datos oficiales: bdns-subsidios (subvenciones) · borme-espana (Registro Mercantil) · catastro-espana (inmuebles).

Qué devuelve (una referencia catastral = una fila)

Ejemplo real (CL GLORIA 51, Santa Cruz de Mudela):

{
  "id": "9872023VH5797S0001WX",
  "referenciaCatastral": "9872023VH5797S0001WX",
  "tipoBien": "urbano",
  "direccion": "CL GLORIA 51 13730 SANTA CRUZ DE MUDELA (CIUDAD REAL)",
  "tipoVia": "CL",
  "nombreVia": "GLORIA",
  "numero": "51",
  "codigoPostal": "13730",
  "municipio": "SANTA CRUZ DE MUDELA",
  "provincia": "CIUDAD REAL",
  "uso": "Residencial",
  "superficie": 308,
  "coeficiente": 100.0,
  "antiguedad": 1980,
  "construcciones": [
    { "destino": "VIVIENDA", "planta": "00", "puerta": "01", "superficie": 109 },
    { "destino": "ALMACEN", "planta": "00", "puerta": "02", "superficie": 187 },
    { "destino": "OTROS USOS", "planta": "00", "puerta": "03", "superficie": 12 }
  ],
  "numConstrucciones": 3,
  "superficieConstruida": 308,
  "fechaConsulta": "2026-11-04"
}

Dos modos de uso

1. Referencias catastrales — pega una o varias RC (14 o 20 caracteres, con o sin espacios, mayúsculas/minúsculas da igual): referenciasCatastrales: "9872023VH5797S, 0545206VK4704F"
2. Búsqueda por dirección — provincia + municipio + tipo de vía + vía + portal: provincia: "Coruña", municipio: "Santiago de Compostela", tipoVia: "CL", via: "Praterias", numero: "3" (sin acentos da igual; la provincia se resuelve contra la lista oficial del Catastro).

Reglas del actor

• Esquema base duro: si la fuente devuelve una fila sin los campos base, el run aborta sin guardar basura.
• Detalle tolerante: si el DNP de una referencia falla, esa fila sale solo con la referencia y el contexto de búsqueda — nunca campos de error, nunca se pierde la fila.
• Anti-duplicados: una referencia = una fila; si la parcela tiene varios bienes, una fila por bien con su RC completa de 20 caracteres (la fuente los lista en lrcdnp y el actor consulta cada uno).
• Contexto tolerante: si la referencia no corresponde a la provincia/municipio indicados, el actor reintenta solo con la RC (única a nivel nacional) y conserva el detalle.
• Filtros validados al inicio: provincia/municipio/vía que no existen abortan el run con un mensaje claro antes de emitir nada.
• Checkpoint: si el run se interrumpe, la siguiente ejecución con los mismos filtros reanuda desde la última referencia procesada.

Casos de uso

• Proptech y tasación: ficha rápida de cada inmueble de un portal (superficies, usos, antigüedad).
• Cruce con BORME (borme-espana): sociedades constituidas → domicilio → inmueble del Catastro.
• Estudios de mercado: inventario de usos y superficies de una dirección completa.
• Operadores de activos: desglose de construcciones por planta y destino (VIVIENDA, ALMACEN, OFICINA...).

Filtros que valida al inicio

Filtro	Comprobación
referenciasCatastrales	Formato 14/20 caracteres; máx. 5.000 por ejecución
provincia	Debe existir en la lista oficial (¡"A CORUÑA", no "LA CORUÑA"!)
municipio	Debe existir en la provincia
tipoVia	Sigla oficial (CL, AV, PS, PZ, CM...)
via + numero	Deben existir; la fuente no lista calles enteras

Precio

Pay-per-event: $0,003 por inmueble (evento por item del dataset). El cómputo del actor lo paga quien lo ejecuta. Efectivo desde el 19-nov-2026 (periodo de aviso de Apify); hasta entonces la ficha muestra "Free".

Fuente y frecuencia

Servicios OVC de la Sede Electrónica del Catastro (oficial, gratuito, sin clave). Consulta en vivo en cada ejecución: no hay caché entre ejecuciones. Ver detalle en FUENTE-CATASTRO.md.

Otros actores de la familia

• Subvenciones BDNS (España) — convocatorias oficiales con cruces BOE y concesiones: apify/bdns-subsidios
• BORME España — nuevas sociedades, disoluciones y cargos del Registro Mercantil: apify/borme-espana
• Subastas España — subastas del BOE con valores, lotes y cruce Catastro directo: apify/subastas-espana