BOE Subastas Scraper + Catastro: Spanish property auctions, enriched

One JSON row per property in Spain's official auction portal (subastas.boe.es), enriched with free cadastral data and ready-to-filter numbers: discount vs. auction value, price per m², days to the deadline. Export Spanish judicial foreclosures, notarial sales and Agencia Tributaria auctions to JSON, CSV or Excel, feed them to Google Sheets, n8n, Make or an AI agent, and monitor new auctions by province.

Judicial foreclosures, notarial sales and tax-agency auctions are published on the BOE's Portal de Subastas. The portal is public but built for humans: one auction per page, four tabs, lots split across sub-pages, and no API. This Actor is the missing BOE Subastas API: it turns the portal into structured data for investors, agencies, analysts and AI agents, and adds what the portal lacks: the property's built surface, year of construction and cadastral use from the Dirección General del Catastro, so you can compare the auction value with the real asset.

No login is used, no personal data of debtors is collected, and the Actor stays at one request per second towards the BOE.

Who uses it

• Property investors looking for repossessed homes (viviendas embargadas), garages, commercial premises or land below market value, filtered by province and by discount on the auction value.
• Real-estate agencies and asesores who want a daily list of new auctions in their area in Excel or Google Sheets.
• Analysts and journalists studying foreclosure volumes, minimum bids and price per square metre by province.
• AI agents and automations (n8n, Make, Zapier, LangChain, MCP) that need small, flat JSON instead of HTML tabs.

What you get per row

Block	Fields
auction	id, URL, type (judicial, notarial, agency), status, start and end date (ISO), BOE announcement id, claimed amount, auction value, appraisal, minimum bid, bid increment, deposit, number of lots, lot number
property	kind (Vivienda, Garaje, Local, Finca rústica, Solar…), description, address, postal code, locality, province and province code, possession status, visitable, registry inscription, IDUFIR, charges, habitual residence, legal title, cadastral reference
catastro	use, built surface m², year built, share, parcel type, cadastral address, municipality, parcel surface m², official map link, list of constructions. null when the auction publishes no cadastral reference
catastroStatus	enriched, no-reference, failed (service error, not charged) or disabled
derived	discountVsAuctionValue (1 − minimum bid / auction value), pricePerM2 with pricePerM2Basis (built or parcel for land), daysToEnd
bids	whether the auction has public bids and the current maximum bid
authority	optional: court, notary or agency running the auction (code, name, institutional address, phone, email)
meta	source attribution and scrape timestamp

Auctions with several lots produce one row per property per lot, each with the lot's own value, minimum bid and deposit.

Input

• Provinces: two-digit INE codes (38 Santa Cruz de Tenerife, 35 Las Palmas, 28 Madrid, 08 Barcelona…) or all for the whole country.
• Status: EJ in progress (default), PU announced, or all.
• Max items: stop after N rows (default 200).
• Enrich with Catastro: on by default.
• Include current maximum bid: on by default (one extra request per auction).
• Include managing authority: off by default.

Example:

{ "provinces": ["38", "35"], "status": "EJ", "maxItems": 500, "enrichCatastro": true }

Pricing

Pay per event, charged only after the row is saved:

• result: $0.002 per property row.
• catastro-enrichment: $0.003 per row that was actually enriched (not charged when the auction has no cadastral reference or the Catastro service fails).

Measured on real runs in October 2026: Madrid (61 active auctions, 83 rows, 36 enriched) cost $0.27; Las Palmas (26 auctions, 92 rows, 11 enriched) cost $0.22; Santa Cruz de Tenerife (15 auctions, 19 rows, 12 enriched) cost $0.07. You are not charged for Apify platform usage.

Quality and limits

• Every row is validated against a strict schema before it is saved; rows that fail validation are logged and not charged.
• Measured on real runs (October 2026, three provinces, 102 auctions, 194 rows): 0 parse issues, 0 failed requests, 3 Catastro lookups rejected because the BOE published an invalid reference (reported as failed, not charged), 1.9 to 3.4 s per row.
• Between 12 % and 63 % of rows carry a cadastral reference depending on the province (Las Palmas 12 %, Madrid 43 %, Tenerife 63 %); the rest get catastroStatus: "no-reference". That is a property of the source, not of the Actor. When the reference is only mentioned inside the free-text description, the Actor still finds it (cadastralReferenceSource: "text").
• Information behind the portal's login ("Información complementaria") is not read.
• The BOE portal publishes bids only when the managing authority makes them public; otherwise bids.hasBids is false.
• Catastro is queried through its free public web service for non-protected data; owner data is never requested.

Attribution and reuse

Data reuse is allowed by the BOE's legal notice for commercial and non-commercial purposes with attribution. Every row carries it in meta.source:

Basado en datos de la Agencia Estatal Boletín Oficial del Estado (https://subastas.boe.es) y de la Dirección General del Catastro

Keep this attribution when you redistribute the data.

How to use it

In the Apify Console: pick provinces, keep the defaults and press Start. Download the dataset as JSON, CSV, Excel or HTML table from the Storage tab.

From your code (Apify API):

curl -X POST "https://api.apify.com/v2/acts/islandata~boe-subastas-catastro/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provinces": ["38"], "status": "EJ", "maxItems": 100}'

In n8n, Make or Zapier: use the Apify node or app, choose this Actor (islandata/boe-subastas-catastro), pass the same JSON input and map the dataset rows to Google Sheets, Airtable, Notion, Slack or email. With status: "PU" (announced auctions) on a daily schedule you get an alert for every new auction in your provinces.

With an AI agent (MCP): connect your agent to https://mcp.apify.com?tools=islandata/boe-subastas-catastro and ask for "auctions in Tenerife with more than 30 % discount and a cadastral reference". The output is small, flat JSON designed for agents: filter on derived.discountVsAuctionValue, derived.pricePerM2 and derived.daysToEnd.

FAQ

Is this the official BOE auctions API? No. The BOE publishes no API for the Portal de Subastas; this Actor reads the public pages at one request per second and structures them. Reuse is allowed by the BOE legal notice with attribution.

Does it include the cadastral reference and surface for every property? Only when the auction publishes a cadastral reference (between 12 % and 63 % of rows depending on the province). The rest are returned with catastroStatus: "no-reference" and are not charged the enrichment fee.

Can I get the whole of Spain? Yes, with provinces: ["all"]. Around 1,500 to 2,500 active auctions are usually open nationwide; set maxItems accordingly.

Does it bid or log in? Never. It reads public information only; nothing behind the portal login is touched.

What about debtors' personal data? None is collected. Only the asset, the auction figures and, optionally, the institutional authority running the auction.

---

Español: subastas del BOE con datos del Catastro, en JSON, CSV o Excel

Una fila JSON por inmueble del Portal de Subastas del BOE, enriquecida con datos catastrales gratuitos y con cifras listas para filtrar: descuento sobre el valor de subasta, precio por m² y días hasta el cierre. Exporta las subastas judiciales, notariales y de la Agencia Tributaria a Excel o Google Sheets, recibe avisos de subastas nuevas por provincia y conéctalas a n8n, Make o un agente de IA.

El Actor recorre subastas.boe.es (ejecuciones hipotecarias y judiciales, subastas notariales y de la Agencia Tributaria: viviendas, garajes, locales, solares y fincas rústicas), lee las pestañas de información general, bienes, pujas y, opcionalmente, autoridad gestora, separa los lotes y consulta el servicio web libre del Catastro para añadir superficie construida, año de construcción y uso. Sin iniciar sesión, sin datos personales de deudores, a una petición por segundo.

Para quién: inversores que buscan viviendas embargadas y locales por debajo del precio de mercado, agencias y asesores que quieren la lista diaria de subastas de su provincia, analistas y periodistas, y automatizaciones o agentes de IA que necesitan JSON plano en vez de pestañas HTML.

Entrada: provincias por código INE (38 Santa Cruz de Tenerife, 35 Las Palmas, 28 Madrid, 08 Barcelona, 46 Valencia, 41 Sevilla, 29 Málaga…) o all para toda España; estado EJ (celebrándose), PU (anunciadas) o all; máximo de filas; enriquecimiento Catastro; puja máxima; autoridad gestora.

Cómo usarlo: desde la consola de Apify (descarga en JSON, CSV o Excel), desde la API de Apify (islandata~boe-subastas-catastro/run-sync-get-dataset-items), desde el nodo de Apify en n8n, Make o Zapier hacia Google Sheets, o desde un agente de IA mediante MCP (https://mcp.apify.com?tools=islandata/boe-subastas-catastro).

Precio: 0,002 $ por fila guardada y 0,003 $ adicionales por fila realmente enriquecida con Catastro. Medido en octubre de 2026: Madrid (61 subastas, 83 filas, 36 enriquecidas) costó 0,27 $; Las Palmas (26 subastas, 92 filas) 0,22 $; Tenerife (15 subastas, 19 filas) 0,07 $. El uso de la plataforma Apify no se cobra aparte.

Calidad: cada fila se valida contra un esquema estricto antes de guardarse; las que fallan no se cobran. Entre el 12 % y el 63 % de las subastas publican referencia catastral según la provincia; el resto llevan catastroStatus: "no-reference" y no pagan el enriquecimiento.

Preguntas frecuentes: no es la API oficial del BOE (no existe); no puja ni inicia sesión; no recoge datos personales de deudores; provinces: ["all"] cubre toda España.

Atribución: la reutilización está permitida por el aviso legal del BOE con cita de la fuente. Cada fila la incluye en meta.source: «Basado en datos de la Agencia Estatal Boletín Oficial del Estado y de la Dirección General del Catastro». Conserva esta atribución al redistribuir los datos.