Subastas BOE Auctions Scraper

Extract public auction opportunities from Spain's official BOE electronic auction portal.

What does Subastas BOE Auctions Scraper do?

Subastas BOE Auctions Scraper collects structured records from subastas.boe.es, the official Spanish electronic auction portal managed by BOE.

It can search active auctions or scrape known BOE auction IDs and detail URLs.

The actor returns one row per auction with deadlines, values, deposits, bids, authority details, asset descriptions, and source URLs.

Who is it for?

Real-estate investors

🏠 Monitor foreclosure and judicial auctions before the deadline.

Legal and insolvency researchers

⚖️ Track official proceedings, case references, claimed amounts, and managing authorities.

Asset brokers

📌 Build lead lists of properties, vehicles, and other auctioned assets.

Proptech and data teams

🔌 Feed official public auction data into dashboards, alerts, CRMs, and valuation tools.

Why use this actor?

• ✅ Official public source: BOE auction portal
• ✅ HTTP-only implementation: no browser overhead
• ✅ Works with active search or known auction IDs
• ✅ Parses Spanish money values into numeric fields
• ✅ Keeps useful raw asset text for downstream enrichment
• ✅ Includes source URLs for auditability

What data can it extract?

Field	Description
id	BOE auction identifier
url	Canonical detail URL
authority	Managing court or authority
caseNumber	BOE case/account reference when available
status	Public auction status from search results
startDateIso	ISO start date when provided by BOE
conclusionIso	ISO deadline when provided by BOE
auctionType	Judicial, notarial, administrative, or other BOE type
claimedAmount	Claimed amount as a number
auctionValue	Auction value as a number
appraisalValue	Appraisal/tasación value as a number
minimumBid	Minimum bid amount when public
bidIncrement	Bid increment amount when public
depositAmount	Deposit amount as a number
highestBid	Public highest bid when BOE exposes it
bidsCount	Public bid count or zero when BOE says no bids
assets	Asset descriptions and addresses from the public asset tab
relatedNotices	Related BOE notice identifiers
scrapedAt	Timestamp of extraction

How much does it cost to scrape Subastas BOE auctions?

This actor uses pay-per-event pricing.

You pay a small start fee per run and a per-auction result fee for each dataset item saved.

Exact live pricing is shown on the Apify Store actor page.

For first tests, keep maxItems at the prefilled value.

How to scrape active BOE auctions

1. Open the actor on Apify.
2. Leave BOE auction URLs empty.
3. Leave BOE auction IDs empty.
4. Set Maximum auctions to a small number such as 10.
5. Keep BOE status code as EJ for auctions in progress.
6. Click Start.
7. Export results from the Dataset tab.

How to scrape known auction IDs

Paste identifiers such as:

SUB-JA-2025-234719

The actor converts them to BOE detail URLs and extracts public details.

How to scrape BOE detail URLs

You can also paste URLs like:

https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2025-234719

This is useful when you already collect BOE links from another system.

Input options

BOE auction URLs

Optional list of BOE detail URLs.

BOE auction IDs

Optional list of BOE identifiers.

Maximum auctions

Caps the number of records saved.

BOE status code

Default is EJ, which means auctions currently in progress.

Fetch detail tabs

When enabled, the actor fetches public BOE tabs for general details, managing authority, assets, related notices, and public bid summary.

Output example

{
  "id": "SUB-JA-2025-234719",
  "url": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2025-234719",
  "authority": "JUZGADO 1 INSTANCIA 1",
  "auctionType": "JUDICIAL EN VÍA DE APREMIO",
  "auctionValue": 180000,
  "depositAmount": 9000,
  "bidsCount": 0,
  "assets": [
    {
      "title": "Datos del bien subastado",
      "description": "FINCA REGISTRAL..."
    }
  ]
}

Tips for better results

• Start with active auctions (EJ) and low maxItems.
• Use auction IDs when monitoring a watchlist.
• Keep includeDetails enabled when you need values, deposits, and assets.
• Disable detail tabs only when you need a fast listing preview.
• Always review BOE source URLs before making investment decisions.

Integrations

Auction alerts

Run the actor daily and alert when new auction IDs appear.

CRM enrichment

Send dataset rows to a CRM as real-estate or asset leads.

Spreadsheet monitoring

Export CSV files to Google Sheets or Excel for manual review.

Valuation pipelines

Combine BOE auction values with cadastral, property, or geocoding datasets.

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/subastas-boe-auctions-scraper').call({
  maxItems: 10,
  statusCode: 'EJ',
  includeDetails: true,
});
console.log(run.defaultDatasetId);

API usage with Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/subastas-boe-auctions-scraper').call(run_input={
    'maxItems': 10,
    'statusCode': 'EJ',
    'includeDetails': True,
})
print(run['defaultDatasetId'])

API usage with cURL

curl -X POST 'https://api.apify.com/v2/acts/automation-lab~subastas-boe-auctions-scraper/runs?token=YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"maxItems":10,"statusCode":"EJ","includeDetails":true}'

MCP usage

Use the Apify MCP server with tools scoped to this actor:

https://mcp.apify.com/?tools=automation-lab/subastas-boe-auctions-scraper

Claude Code setup:

$claude mcp add apify-subastas-boe https://mcp.apify.com/?tools=automation-lab/subastas-boe-auctions-scraper

Claude Desktop JSON configuration:

{
  "mcpServers": {
    "apify-subastas-boe": {
      "url": "https://mcp.apify.com/?tools=automation-lab/subastas-boe-auctions-scraper"
    }
  }
}

Example prompts showing MCP usage:

• "Use the Apify Subastas BOE tool to run 20 active auctions and summarize the biggest deposits."
• "Use MCP to find BOE auctions ending this week and list their source URLs."
• "Run the actor through MCP for auction ID SUB-JA-2025-234719 and explain the deposit and value fields."
• "Export auction IDs and values into a table for investor review."

Data quality notes

The actor only extracts fields that BOE makes public without logging in.

Some complementary documents or bidder actions may require a BOE account and are not scraped.

Spanish date strings are preserved, and ISO values are extracted when BOE includes them in the page.

Limitations

• Login-only complementary files are out of scope.
• BOE can change public status codes or page markup.
• Asset text can be long because legal descriptions are verbose.
• The actor does not provide legal, investment, or valuation advice.

Legality

This actor collects publicly visible information from an official public website.

You are responsible for using the data in compliance with applicable laws, BOE terms, and privacy obligations.

Do not use the actor to access account-only bidder workflows.

FAQ

Why did I get zero results?

The selected BOE status code may have no current auctions. Try EJ or provide known auction IDs.

Why are some values null?

BOE sometimes writes values as "Sin puja mínima", "Sin tramos", or omits fields. The actor returns null for those numeric fields.

Why is the asset text long?

BOE legal descriptions often include registry, location, possession, charges, and other legal wording in one public block.

Related scrapers

Explore related official-data actors from Automation Lab:

• https://apify.com/automation-lab/boe-scraper
• https://apify.com/automation-lab/spain-procurement-scraper
• https://apify.com/automation-lab/eu-tenders-scraper

Changelog

0.1

Initial version with active search, auction ID scraping, public detail tabs, values, deposits, bids, assets, and related notices.

Support

If a BOE page changes or you need a field from a public tab, open an issue on the Apify actor page with a sample auction URL.