Spanish Auction Scraper -- Subastas BOE Foreclosures

Extract judicial and government auctions from Spain's official Subastas BOE portal. Search real estate foreclosures, vehicle auctions, and asset sales across all Spanish provinces. Returns property details, court information, bid amounts, deposit requirements, and authority contact data. No cookies, no login required.

How to scrape Subastas BOE data

This actor scrapes the official Spanish government auction portal (subastas.boe.es), operated by the State Official Gazette Agency. It covers judicial auctions (foreclosures), tax authority asset sales, notarial auctions, and administrative auctions across all 52 Spanish provinces.

Search by province

Filter auctions by Spanish province code. Popular codes: 28 (Madrid), 08 (Barcelona), 46 (Valencia), 41 (Sevilla), 29 (Malaga), 03 (Alicante), 11 (Cadiz), 07 (Illes Balears). Leave empty to search all provinces.

Filter by asset type

Choose between real estate (inmuebles), vehicles (vehiculos), or other movable assets. Real estate includes apartments, houses, commercial premises, garages, land, and industrial buildings. Vehicles include cars, motorcycles, and industrial vehicles.

Filter by auction type

• Judicial -- Court-ordered foreclosures and asset liquidations. The most common type.
• AEAT (Tax Authority) -- Properties seized by Spain's tax agency for unpaid taxes.
• Notarial -- Auctions conducted through notarial procedures.
• Administrative -- General government administrative auctions.

Active vs upcoming auctions

By default, the scraper returns active auctions (currently accepting bids). Switch to "Upcoming" to see auctions that haven't started yet, or "Any status" for the broadest results.

What data does Subastas BOE Scraper extract?

Field	Type	Description
auctionId	String	Unique auction ID (e.g., SUB-JA-2026-261340)
auctionType	String	Type (Judicial, Notarial, AEAT, Administrative)
court	String	Court or authority managing the auction
caseNumber	String	Case/expediente number
status	String	Current status and expected end date
endDate	String	Auction end date and time
description	String	Brief asset description from listing
auctionValue	String	Starting auction value
appraisalValue	String	Official appraised value
minimumBid	String	Minimum bid amount
bidIncrement	String	Minimum increment between bids
depositAmount	String	Required deposit to participate
claimedAmount	String	Total debt being recovered
lots	String	Number of lots in the auction
boeAnnouncement	String	Official BOE announcement reference
authorityCode	String	Managing authority code
authorityName	String	Court or authority name
authorityAddress	String	Authority address
authorityPhone	String	Contact phone
authorityEmail	String	Contact email
assetDescription	String	Full property description
assetAddress	String	Property address
assetPostalCode	String	Postal code
assetCity	String	City
assetProvince	String	Province
isPrimaryResidence	String	Whether it is a primary residence
possessionStatus	String	Occupancy status
isVisitable	String	Whether property visits are allowed
detailUrl	String	Direct link to full auction details
scrapedAt	String	ISO timestamp of extraction

Example output

{
    "auctionId": "SUB-JA-2026-261340",
    "auctionType": "JUDICIAL EN VIA DE APREMIO",
    "court": "Seccion Civil e Instruc TI Getafe. Plz.n 4 - GETAFE",
    "caseNumber": "2379 0000 06 0157 21",
    "status": "Celebrandose - [Conclusion prevista: 11/06/2026 a las 18:00:00]",
    "endDate": "11-06-2026 18:00:00 CET",
    "description": "Urbana,- Piso tercero, Letra b de la casa numero dieciseis, de la calle Alicante en Getafe (Madrid).",
    "auctionValue": "194.400,00 EUR",
    "appraisalValue": "0,00 EUR",
    "minimumBid": "Sin puja minima",
    "bidIncrement": "3.888,00 EUR",
    "depositAmount": "9.720,00 EUR",
    "claimedAmount": "157.241,54 EUR",
    "lots": "Sin lotes",
    "boeAnnouncement": "BOE-B-2026-16058",
    "authorityCode": "2806541004",
    "authorityName": "Seccion Civil e Instruc TI Getafe. Plz.n 4",
    "authorityAddress": "AV JUAN CARLOS I S/N S/N ; 28905 GETAFE",
    "authorityPhone": "919499470",
    "authorityEmail": "sejecucioncivil.getafe@madrid.org",
    "assetDescription": "Urbana,- Piso tercero, Letra b de la casa numero dieciseis, de la calle Alicante en Getafe (Madrid).",
    "assetAddress": "calle Alicante 16, 3B",
    "assetPostalCode": "28903",
    "assetCity": "getafe",
    "assetProvince": "Madrid",
    "isPrimaryResidence": "Si",
    "possessionStatus": "No consta",
    "isVisitable": "No consta",
    "detailUrl": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-261340",
    "scrapedAt": "2026-05-23T10:00:00.000Z"
}

Use cases

• Real estate investors -- Find below-market properties from judicial foreclosures across Spain.
• Bargain hunters -- Monitor vehicle and asset auctions for deals.
• Legal professionals -- Track judicial auction proceedings and outcomes.
• Market research -- Analyze foreclosure trends by province, property type, and value.
• Property portals -- Aggregate auction listings alongside regular property listings.

Tips for best results

• Start with active auctions: Default status "Celebrandose" shows only auctions currently accepting bids.
• Province focus: Narrow by province to get manageable result sets. Madrid (28) and Barcelona (08) have the most auctions.
• Real estate focus: Set asset type to "Inmuebles" for property-only results.
• Disable details for speed: Set "Include Full Details" to false for a quick listing scan without per-auction detail fetches.

How much does it cost?

Search size	Estimated time	Estimated cost
10 auctions (with details)	~1 minute	~$0.05
50 auctions (with details)	~5 minutes	~$0.20
50 auctions (listing only)	~10 seconds	~$0.01

Can I use it as an API?

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("studio-amba/subastas-boe-scraper").call(run_input={
    "province": "28",
    "assetType": "I",
    "auctionStatus": "EJ",
    "maxResults": 20,
})

for auction in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{auction['auctionId']} | {auction['auctionValue']} | {auction['assetCity']}")

Limitations

• The Subastas BOE portal does not provide an API, so this actor scrapes HTML pages.
• Detail fetching requires 3 HTTP requests per auction (general + authority + assets tabs). Use "listing only" mode for faster results.
• Multi-lot auctions show the first lot's details. Individual lot data may require manual inspection.
• The portal may be slow during peak hours.

Other Spanish data scrapers

• BOE Official Gazette Scraper -- Spanish laws, decrees, and public notices
• BOAMP Scraper -- French public procurement tenders

Your feedback

Found a bug or want a feature? Open an issue on the Issues tab.