Spain Land & Property Cadastral Enrichment

Listings say what the seller wants. The Cadastre says what is there.

Give this Actor a Spanish address — or a whole dataset from any real-estate scraper — and it returns the official record from Spain's Cadastre: real surface in m², official use, year, existing constructions, and the cadastral reference.

That reference is the point. It's the legal identity of the plot, the one you take to the Land Registry. Without it, a listing is just a claim.

{
  "input": "Calle Alfonso I, 1, 50003 Zaragoza",
  "cadastralReference": "6437117XM7163E0002LK",
  "parcelReference": "6437117XM7163E",
  "surfaceM2": 7161,
  "use": "Ocio y Hosteleria",
  "yearBuilt": 2010,
  "propertyClass": "UR",
  "address": "CL ALFONSO I 1 50003 ZARAGOZA (ZARAGOZA)",
  "constructions": [
    { "use": "ALMACEN", "surfaceM2": 320, "floor": "-1" },
    { "use": "OCIO Y HOSTELERIA", "surfaceM2": 1200, "floor": "00" }
  ],
  "status": "found"
}

Who this is for

• Land scouts and developers sourcing plots: check the surface a listing claims, before you drive out to see it.
• Real-estate agencies and portals: verify and normalize a whole portfolio at once.
• Valuation, lending and insurance: official surface, use and age, at scale.
• Anyone running a Spanish property scraper: this is the layer that turns listings into verified records.

Three ways in — the third is the point

1. Addresses as written in a listing: Calle Alfonso I, 1, 50003 Zaragoza. Street type, name, number, postcode and town are parsed for you.
2. Cadastral references (14 or 20 characters) — exact, no parsing involved.
3. sourceDatasetId of another Actor. Run any Idealista / Fotocasa / Milanuncios scraper, paste that run's dataset ID, and addresses are read straight from it. No CSV export, no copying columns.

Land mode: one record per parcel

A street number returns every property in the building — one per flat. With parcelLevel on (the default) you get the parcel once, which is what matters for land, and you're charged once. Turn it off when you want every individual unit.

It asks the Cadastre how it spells things

Spanish addresses don't match the Cadastre's own spelling, and that's the single biggest source of failure. Before looking anything up, this Actor resolves the street against the official street index:

A listing writes	The Cadastre stores
Calle Mariano Lagasca	CL LAGASCA, MARIANO — surname first
Calle Gran Vía (Zaragoza)	PS GRAN VIA (RAMON Y CAJAL) — it's a paseo, not a street

That normalization alone took the hit rate from 55% to 68%.

Hit rate, measured — not promised

68% on 20 real listing-style addresses across Zaragoza, Madrid and Valencia (30 July 2026). Exact cadastral references resolve essentially always — the loss is all in address matching.

The remaining failures are almost entirely "street exists, that number doesn't". The Actor reports that instead of guessing. It will never snap to a nearby number: a different number is a different building, and handing you the wrong plot would be worse than handing you nothing.

You only pay for records actually delivered. Addresses that don't resolve cost you nothing.

Input

Field	Default	What it does
addresses	—	Spanish addresses, as written in listings
cadastralReferences	—	Cadastral references (14 or 20 chars)
sourceDatasetId	—	Dataset ID of any real-estate scraper
sourceDatasetField	auto	Field holding the address (autodetected)
province / municipality	—	Force them when addresses omit the town
parcelLevel	true	One record per parcel instead of per unit
maxItems	200	Cap per run

Pricing

Event	When you're charged
Property enriched	Only when the Cadastre returns an actual record

Limits, up front

• No ownership data. Owner names are protected under Spanish law and this service does not serve them. What you get is the unprotected cadastral data: surface, use, situation, constructions. If you need to know who owns it, this Actor is not what you want.
• No buildability. The Cadastre states the current use, not what the municipal plan allows you to build. That's the number a land scout most wants, it lives in scattered municipal planning documents, and it is not in here.
• Rural parcels follow a different query branch and are less reliable than urban ones in this version.
• The Cadastre's service is a free public API. This Actor caches by reference, keeps concurrency low and backs off — please don't hammer it.

Source

Official data from the Sede Electrónica del Catastro (Spanish Ministry of Finance), servicio de consulta libre — the public, unauthenticated endpoint for unprotected cadastral data. Reuse of Spanish public-sector information is governed by Ley 37/2007.