Spain BOE Auctions Scraper

Extract Spain's official public auctions (subastas) from the government BOE portal at subastas.boe.es — judicial foreclosures, notarial sales, and Tax Agency (AEAT) auctions, complete with appraised values, deposits, minimum bids, court and notary contacts, and every asset lot. Built for real-estate investors, distressed-asset sourcers, and legal-research teams who need a clean, structured feed of Spanish foreclosure and asset auctions without trawling the BOE portal auction by auction.

Why This Scraper?

• Judicial, notarial, and Tax Agency auctions in one feed — court-ordered foreclosures, notarial sales, and Agencia Tributaria (AEAT) tax auctions of seized property and vehicles, with a one-switch filter to isolate Tax Agency auctions only.
• Every euro figure — on the auction and on each lot — appraised value, auction/base value, deposit, minimum bid, bid increment, and the claimed debt amount, plus auto-calculated 70% and 50% reference thresholds that decide whether a bid clears or needs court approval; multi-lot auctions roll their per-lot values up into an auction-level total.
• One row per asset lot, not one blurred summary — a single foreclosure can bundle dozens of lots, and each lands as its own record with its own value, appraisal, address, and encumbrances (cargas), so a 40-lot bankruptcy sale becomes 40 workable rows.
• 8 real-estate asset types to filter by — housing, commercial premises, garage, storage room, industrial unit, building plot, rural land, or other, matching BOE's own asset taxonomy so you pull only the category you invest in.
• All 52 Spanish provinces — every province plus Ceuta and Melilla, selectable by name, so you can farm one region or sweep the whole country in a single run.
• Court and notary contact details on every auction — authority name, email, phone, fax, postal address, and BOE code, so leads arrive ready to contact without a second lookup.
• Attached legal PDFs — links or full downloads — capture every document's title and public link (edicts, appraisal reports, registry notes), or flip one switch to pull the PDF files themselves into your run's storage.
• Appraised-value and date-range windows — set a minimum and maximum appraised value in euros and open/close date ranges to track only the auctions worth your time, or just the newly published ones.
• A ready-to-open map link for every asset — each auction and lot ships a Google Maps search link built from its street address, postal code, and municipality, so you can eyeball location the moment the data lands.

Use Cases

Real-Estate Investment & Sourcing

• Build a pipeline of foreclosed flats, houses, and commercial units priced below market appraisal
• Compare auction value, the 70% threshold, and the claimed debt to spot lots worth bidding on
• Track live housing auctions across your target provinces every morning

Distressed-Asset & Bankruptcy Sourcing

• Surface multi-lot concurso (bankruptcy) auctions where one filing sells dozens of assets at once
• Isolate Agencia Tributaria (AEAT) tax auctions of seized real estate and vehicles
• Filter industrial units, rural land, and building plots for specialist buyers

Legal & Compliance Research

• Pull the full authority contact and case reference for any auction of interest
• Archive attached edicts and appraisal PDFs into your due-diligence files
• Monitor a specific court's or notary's published auctions over time

Lead Generation

• Feed CRM pipelines with auction leads plus the court or notary contact to reach out
• Alert clients the moment an auction matching their budget and province opens
• Build province-by-province lists of upcoming (Pendiente) auctions to prospect early

Market Analysis & Reporting

• Chart appraised-value distributions by province, asset type, and status
• Measure how deeply lots discount from appraisal down to the minimum bid
• Track auction volume and outcomes across judicial versus Tax Agency channels

Getting Started

Live Housing Auctions in One Province

The simplest useful run — live housing auctions in Madrid:

{
    "province": "Madrid",
    "propertyType": "Vivienda",
    "auctionStatus": "Celebrándose",
    "maxResults": 50
}

Filtered by Value and Closing Date

Live flats in Barcelona between €50k and €250k, closing over the next few months, soonest first:

{
    "province": "Barcelona",
    "propertyType": "Vivienda",
    "auctionStatus": "Celebrándose",
    "minValue": 50000,
    "maxValue": 250000,
    "endDateFrom": "2026-07-15",
    "endDateTo": "2026-09-30",
    "sortBy": "endDate",
    "sortOrder": "asc",
    "maxResults": 200
}

Tax Agency Auctions with Document Downloads

Every live Agencia Tributaria auction, with the attached PDFs saved to your run:

{
    "taxAgencyOnly": true,
    "auctionStatus": "Celebrándose",
    "downloadDocuments": true,
    "maxResults": 100
}

Scrape Specific Auctions by URL

Paste one or more auction links (or a pre-filtered search-results link) to skip the filters entirely:

{
    "startUrls": [
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263383"
    ]
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
startUrls	array	[]	Paste subastas.boe.es links — individual auction pages or full search-results pages. Leave empty to build a search with the filters below.

Filters

Parameter	Type	Default	Description
province	string	All provinces	Restrict to assets in one Spanish province. 52 options — all 50 provinces plus Ceuta and Melilla.
propertyType	string	All types	Restrict to one asset category: Housing (Vivienda), Commercial premises (Local comercial), Garage (Garaje), Storage room (Trastero), Industrial unit (Nave industrial), Building plot (Solar), Rural land (Finca rústica), or Other (Otros).
auctionStatus	string	Live / ongoing (Celebrándose)	Auction state: Any status, Live / ongoing (Celebrándose), Upcoming (Pendiente), Concluded (Concluida), or Suspended (Suspendida).
taxAgencyOnly	boolean	false	When on, return only auctions run by the Spanish Tax Agency (Agencia Tributaria / Hacienda).
minValue	integer	null	Keep only auctions whose appraised value is at or above this amount, in euros.
maxValue	integer	null	Keep only auctions whose appraised value is at or below this amount, in euros.

Date Range

Parameter	Type	Default	Description
startDateFrom	string	null	Only auctions that open on or after this date (YYYY-MM-DD).
startDateTo	string	null	Only auctions that open on or before this date (YYYY-MM-DD).
endDateFrom	string	null	Only auctions that close on or after this date (YYYY-MM-DD).
endDateTo	string	null	Only auctions that close on or before this date (YYYY-MM-DD).

Sorting & Limits

Parameter	Type	Default	Description
sortBy	string	Auction end date	Order results by Auction end date or Auction ID.
sortOrder	string	Ascending	Ascending (oldest / lowest first) or Descending (newest / highest first).
maxResults	integer	100	Maximum number of auctions to collect. Set to 0 to collect every match.

Documents

Parameter	Type	Default	Description
downloadDocuments	boolean	false	When on, each auction's attached PDFs (edicts, appraisals, etc.) are downloaded into your run's storage and every document gets a direct download link. Off keeps just titles and public URLs.

Output

The dataset holds two kinds of rows: one auction record per auction, and one asset-lot record for every lot inside it. A recordType value on each row tells the two apart, and every lot carries its parent auction's ID so you can join them.

Auction Records

{
    "recordType": "auction",
    "identifier": "SUB-JA-2026-263383",
    "auctionType": "Subasta judicial",
    "status": "Celebrándose",
    "startDate": "2026-06-23T18:00:00+02:00",
    "endDate": "2026-07-13T18:00:00+02:00",
    "auctionValue": 185000.00,
    "appraisalValue": 185000.00,
    "referenceValue70": 129500.00,
    "referenceValue50": 92500.00,
    "deposit": 9250.00,
    "minimumBid": 92500.00,
    "bidIncrement": 1000.00,
    "claimedAmount": 74213.55,
    "boeAnnouncement": "BOE-B-2026-19427",
    "caseNumber": "0512/2023",
    "lotCount": 1,
    "authorityName": "Juzgado de Primera Instancia e Instrucción nº 2 de Soria",
    "authorityEmail": "subastas.soria@justicia.es",
    "authorityPhone": "975 21 10 00",
    "authorityFax": "975 21 10 01",
    "authorityAddress": "Aguirre 3, 42002 Soria",
    "authorityCode": "4229100011",
    "taxAgency": false,
    "description": "Vivienda unifamiliar con parcela",
    "fullDescription": "URBANA: vivienda unifamiliar de 120 m² con parcela de 300 m², sita en Calle Mayor 14, Soria, inscrita en el Registro de la Propiedad de Soria al tomo 1234, libro 56, folio 78, finca registral 9012.",
    "address": "Calle Mayor 14",
    "postalCode": "42001",
    "locality": "Soria",
    "province": "Soria",
    "documents": [
        { "title": "Edicto", "url": "https://subastas.boe.es/verDocumento.php?idSub=SUB-JA-2026-263383&idDoc=abc123" }
    ],
    "detailUrl": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263383&ver=1",
    "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=Calle+Mayor+14%2C+42001+Soria"
}

Core Fields

Field	Type	Description
recordType	string	Always "auction" for auction-level rows
identifier	string	Unique BOE auction ID (e.g. SUB-JA-2026-263383)
auctionType	string	Auction classification (judicial, notarial, etc.)
status	string	Live, upcoming, concluded, or suspended
startDate	string	Auction opening date and time (ISO 8601)
endDate	string	Auction closing date and time (ISO 8601)
lotCount	number	Number of asset lots in this auction
taxAgency	boolean	true when the auction is run by the Spanish Tax Agency (AEAT)
detailUrl	string	Link to the auction page on subastas.boe.es

Financials

Field	Type	Description
auctionValue	number	Base / auction value, in euros
appraisalValue	number	Appraised (tasación) value, in euros
referenceValue70	number	70% of the auction value — the common bidding threshold
referenceValue50	number	50% of the auction value — the floor below which court approval applies
deposit	number	Deposit required to bid, in euros
minimumBid	number	Minimum accepted bid, in euros
bidIncrement	number	Increment between bids (tramos), in euros
claimedAmount	number	Amount claimed in the underlying case, in euros

For single-lot auctions every figure sits directly on the auction record. For multi-lot auctions, auctionValue and appraisalValue (and the referenceValue70 / referenceValue50 derived from them) are the combined totals across all lots, while deposit, minimumBid, and bidIncrement are set per lot — read each asset-lot record for its own figures.

Authority Contact

Field	Type	Description
authorityName	string	Court or notary running the auction
authorityEmail	string	Authority contact email
authorityPhone	string	Authority contact phone
authorityFax	string	Authority contact fax
authorityAddress	string	Authority postal address
authorityCode	string	BOE authority code

Asset Summary & Documents

Field	Type	Description
description	string	Short description of the lead asset
fullDescription	string	Full cadastral/registry description of the lead asset
address	string	Street address of the lead asset
postalCode	string	Postal code
locality	string	Municipality
province	string	Spanish province
googleMapsUrl	string	Google Maps search link for the address
boeAnnouncement	string	BOE bulletin announcement reference
caseNumber	string	Case / file reference (expediente)
documents	array	Attached documents: title + public url (plus a download link when documents are downloaded)

Asset-Lot Records

{
    "recordType": "lot",
    "auctionId": "SUB-JA-2026-263383",
    "lotNumber": 1,
    "auctionValue": 185000.00,
    "appraisalValue": 185000.00,
    "deposit": 9250.00,
    "minimumBid": 92500.00,
    "bidIncrement": 1000.00,
    "description": "Vivienda unifamiliar de 120 m² con parcela de 300 m²",
    "fullDescription": "URBANA: número veintiséis. Vivienda unifamiliar de 120 m² con parcela de 300 m², situada en Calle Mayor 14, 42001 Soria. Referencia catastral 1234567AB1234C0001DE, inscrita en el Registro de la Propiedad de Soria, finca registral 9012.",
    "address": "Calle Mayor 14",
    "postalCode": "42001",
    "locality": "Soria",
    "province": "Soria",
    "primaryResidence": "Sí",
    "possession": "Desconocida",
    "visitable": "No",
    "encumbrances": "Sin cargas conocidas",
    "detailUrl": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263383&ver=3&idLote=1",
    "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=Calle+Mayor+14%2C+42001+Soria"
}

Field	Type	Description
recordType	string	Always "lot" for asset-lot rows
auctionId	string	Parent auction ID this lot belongs to
lotNumber	number	Lot position within the auction (1, 2, 3, …)
auctionValue	number	This lot's auction value, in euros
appraisalValue	number	This lot's appraised value, in euros
deposit	number	Deposit required for this lot, in euros
minimumBid	number	Minimum bid for this lot, in euros
bidIncrement	number	Bid increment for this lot, in euros
description	string	Short one-line summary of the asset
fullDescription	string	Full cadastral/registry description of the asset
address	string	Street address
postalCode	string	Postal code
locality	string	Municipality
province	string	Spanish province
primaryResidence	string	Whether the property is the debtor's primary residence (vivienda habitual)
possession	string	Possession status (situación posesoria)
visitable	string	Whether the asset can be visited
encumbrances	string	Charges or liens on the asset (cargas)
detailUrl	string	Link to this lot on subastas.boe.es
googleMapsUrl	string	Google Maps search link for the lot address

Tips for Best Results

• Narrow before you sweep. An "Any status" search with no other filter matches more auctions than the portal will list at once; pair a province, asset type, or status with a date range so every run returns a full result set instead of an overload page.
• Value filters read every lot. The minimum and maximum appraised-value filters keep an auction when the parent or any one of its lots falls in range, so a mixed multi-lot auction is never dropped just because a single lot sits out of band. On very large result sets a very restrictive value range scans a bounded number of pages, so pair it with a province, status, or date range to keep every match in view.
• Use a start-date "from" to catch new listings. Set startDateFrom to today to pull only newly opened auctions — ideal for a daily or weekly monitoring schedule.
• Prospect early with Upcoming. Switch auctionStatus to Upcoming (Pendiente) to build lists of auctions before they open and reach out ahead of the crowd.
• Budget for lots, not just auctions. A multi-lot bankruptcy auction can expand into dozens of asset-lot rows; if you set a tight maxResults, remember each auction may produce several lot rows.
• Turn documents on only when you need the files. Leave downloadDocuments off to capture titles and links cheaply; switch it on when you want the edicts and appraisal PDFs saved to your run's storage.
• Paste a link to refresh one auction. Drop a specific auction URL into startUrls to re-pull a single subasta's figures and lots without re-running a whole search.

Pricing

Pay per result: from $2.50 per 1,000 auctions plus $0.50 per 1,000 asset lots (Gold tier) — you're charged for the auctions and lots you actually collect, nothing else. No compute or time-based charges; just a small fixed per-run start fee.

Two charge events make up a run — one per auction record and one per asset-lot record. Loyalty-tier discounts apply automatically on the Apify Console:

Charge event	No discount	Bronze	Silver	Gold
Auctions (per 1,000)	$3.00	$2.85	$2.65	$2.50
Asset lots (per 1,000)	$0.60	$0.57	$0.53	$0.50

Because most auctions carry one or two lots, a typical run costs close to the auction rate. Here's the total at Gold prices for a few realistic mixes:

Run	Auction charges	Lot charges	Total (Gold)
500 auctions, ~1.4 lots each	500 × $0.0025 = $1.25	700 × $0.0005 = $0.35	$1.60
1,000 auctions, ~1.4 lots each	1,000 × $0.0025 = $2.50	1,400 × $0.0005 = $0.70	$3.20
5,000 auctions, ~1.5 lots each	5,000 × $0.0025 = $12.50	7,500 × $0.0005 = $3.75	$16.25

A small fixed start fee applies once per run. Platform fees (storage, data transfer) depend on your Apify plan and are additional.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new auctions
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor collects public auction information published by Spain's Boletín Oficial del Estado (BOE) on its official subastas.boe.es portal — data that is public and official by design. It is intended for legitimate real-estate research, distressed-asset sourcing, legal and compliance work, and market analysis. Users are responsible for complying with applicable laws and the portal's terms of service, making reasonable-rate requests, and handling any personal data (such as authority contacts) lawfully and responsibly. Do not use extracted data for spam, harassment, or any unlawful purpose.