Spain BOE Gazette Scraper

Spain BOE Gazette Scraper

Scrape Spain's BOE official gazette by date or date range, up to a million documents per run. Every document comes with its section, title, issuing body, and direct links to the PDF and HTML. No login or API key. Export to CSV, JSON, Excel, or XML.

Spain's Boletín Oficial del Estado (BOE) publishes every law, royal decree, public appointment, and official notice, but its website is built for reading one day at a time. This Actor reads the public gazette directly, filtered by date, section, or a full date range, and returns each document in one fixed schema. Legal researchers, compliance teams, and procurement analysts get the official record without manual copying.

Who uses it	What they scrape Spain BOE Gazette for
Legal researchers	Monitor new laws and royal decrees as they are published
Compliance officers	Track regulatory changes that affect their industry
Procurement analysts	Find public sector contract announcements in section 5A
Journalists	Follow official appointments and government decisions
Data providers	Build a structured feed of BOE documents for downstream applications

What it does

This Actor collects BOE gazette documents by single date or date range, optionally filtered by section, and returns each one as a flat row with its metadata and links.

• 📅 Single date or range: collect one day with date, or every day from startDate to endDate inclusive.
• 🗂️ Section filter: limit to specific BOE sections like 1 (general provisions), 2A (appointments), or 5A (public contracts).
• 🔗 Direct links: each document includes the official PDF and HTML URLs from the BOE website.
• ⚙️ Run limits: cap the number of documents per run with maxItems to control output size.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Spain BOE Gazette data

📜 Monitor new legislation.

A legal researcher runs the Actor daily with section 1 to capture every new law and royal decree, then reviews the PDFs for relevant changes.

📊 Track public procurement.

A procurement analyst collects section 5A for the past month to build a list of open contract announcements and their issuing bodies.

🗞️ Follow official appointments.

A journalist scrapes section 2A each week to report on new government appointments and personnel changes.

📁 Build a compliance archive.

A compliance officer runs the Actor quarterly over a date range to archive all BOE documents that mention their industry, then stores the structured data.

Why choose this scraper

	What you get
Official source	Data comes directly from the BOE website, the authoritative gazette of Spain
Structured output	Each document is a flat row with section, title, department, and links
Flexible dates	Collect one day or a full range, including weekends and holidays when the BOE is empty
No API key	Uses the public BOE pages, so no registration or authentication is needed

How it compares

This Actor focuses on straightforward date and section collection of BOE documents, while some competitors add keyword or department filters.

Feature	ParseForge	BOE Scraper - Spanish Official Gazette	BOE Scraper - Spain Official Gazette
Filter by date	Yes	Yes	Yes
Filter by section	Yes	Yes	Yes
Filter by department	Not listed	Yes	Yes
Filter by keyword	Not listed	Yes	Not listed
Direct PDF and HTML links	Yes	Yes	Not listed
Date range collection	Yes	Not listed	Not listed

Configure the run

Drive the Actor with a single date or a start and end date, and narrow results by BOE section. Filters run as each document is read, so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
 "date": "20240102",
 "maxItems": 10
}

A larger pull:

{
 "date": "20240102",
 "maxItems": 200
}

Pricing

Pay-per-result: $0.004 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$0.40
1,000 results	$4.00
10,000 results	$40.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the Spain BOE Gazette Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Spain BOE Gazette through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/spain-boe-gazette-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that the date is in YYYYMMDD format and is a valid publication day. Weekends and public holidays usually have no BOE. Also verify that your section filter, if set, matches the sections published that day.

Why did the run stop before collecting all documents?

The maxItems limit was reached. Increase it if you need more documents, up to 1,000,000.

Why are some documents missing from my section filter?

Make sure you used the correct section code. For example, public contracts are in 5A, not 5. The section codes are listed in the input schema.

Why is the date range not working?

Both startDate and endDate must be set for the range to activate. If only one is set, the Actor falls back to the single date field.

Why are the PDF links not opening?

The links point to the official BOE website. If the BOE site is temporarily down or has changed its URL structure, the links may not work. Try again later or check the BOE website directly.

FAQ

Question	Answer
What is the BOE?	The Boletín Oficial del Estado (BOE) is Spain's official government gazette. It publishes laws, royal decrees, public appointments, official notices, and procurement announcements.
How do I specify a date?	Use the date field for a single day in YYYYMMDD format, for example 20240102. For a range, set both startDate and endDate; the single date is then ignored.
Can I filter by section?	Yes. The sections field accepts an array of section codes like 1, 2A, 2B, 3, 4, 5A, 5B, or 5C. Leave it empty to collect all sections.
What does each document include?	Each row contains the document's section, title, issuing body, publication date, and direct links to the official PDF and HTML versions.
Is there a limit on how many documents I can collect?	You can set maxItems to any number from 1 to 1,000,000. The Actor stops after reaching that count.
Does this Actor require an API key or login?	No. It reads the public BOE website directly, so no registration or authentication is needed.
What happens on weekends or public holidays?	The BOE usually does not publish on weekends or public holidays. If you request such a date, the Actor returns an empty dataset.
Can I export the data?	Yes. You can export the results to CSV, JSON, Excel, or XML from the Apify dataset.
Is the data in Spanish?	Yes, the BOE publishes in Spanish. The Actor returns the original Spanish text and metadata.
Can I schedule this Actor to run automatically?	Yes, you can set up a schedule in Apify to run it daily, weekly, or at any interval you need.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Agencia Estatal Boletín Oficial del Estado. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.