🇪🇸 Spain BOE Gazette Scraper

🚀 Turn any day of Spain's official gazette into a clean feed of items. A single weekday like 2024-01-02 returns 115 individual entries, each with its BOE identifier, title, section, department and document links.

🕒 Last updated: 2026-06-05 · 📊 15 fields per record · daily summaries from 2024 onward · every section of the Boletín Oficial del Estado

The Boletín Oficial del Estado (BOE) is the official gazette of the Government of Spain. Every working day it publishes laws, royal decrees, appointments, public sector tenders, grants, judicial notices and other official announcements. This Actor reads the keyless Open Data summary feed published by the Agencia Estatal BOE and flattens the nested daily structure into one tidy record per gazette item.

You give it a date or a date range. It walks the diary, section, department and epigraph hierarchy and returns each item with a stable identifier in the BOE-x-YYYY-N form, the full Spanish title, the section and department it belongs to, the publication date, and direct links to the PDF, HTML and XML versions of the document.

🎯 Target Audience	💡 Primary Use Cases
Legal and compliance teams	Track new laws, decrees and regulatory changes
Public sector bidders	Monitor tenders and procurement notices
Researchers and journalists	Build datasets of official Spanish publications
Grant and subsidy seekers	Watch for new aid and funding announcements
GovTech and legal tech builders	Feed structured gazette data into applications

📋 What the Spain BOE Gazette Scraper does

• Reads the official daily summary from the Agencia Estatal BOE Open Data API.
• Accepts a single date (YYYYMMDD) or an inclusive date range.
• Flattens the nested diary, section, department and epigraph tree into flat records.
• Returns one record per gazette item with its BOE identifier and Spanish title.
• Captures the section code and name, department code and name, and epigraph.
• Provides direct PDF, HTML and XML links for each item.
• Skips empty days (weekends and holidays) without failing the run.
• Lets you filter by one or more BOE sections.

🎬 Full Demo (🚧 Coming soon)

⚙️ Input

Field	Type	Description
date	string	Single publication date as YYYYMMDD. Defaults to 20240102 when no range is set.
startDate	string	First day of an inclusive range, as YYYYMMDD.
endDate	string	Last day of an inclusive range, as YYYYMMDD.
sections	array	Optional list of BOE section codes to keep. Empty means every section.
maxItems	integer	Cap on the number of records collected.

Single date:

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

Date range, only general provisions and other dispositions:

{
    "startDate": "20240102",
    "endDate": "20240105",
    "sections": ["1", "3"],
    "maxItems": 500
}

⚠️ Good to Know: the BOE is not published every calendar day. Sundays and most public holidays have no edition, so those days return zero items. Pick a weekday when testing, and use a range if you want continuous coverage across a span.

📊 Output

Each record describes a single gazette item.

Field	Description
🆔 identifier	BOE item identifier, for example BOE-A-2024-87
📌 title	Full Spanish title of the item
🔢 controlNumber	Internal BOE control number
🏷 sectionCode	Section code, for example 2A
📂 sectionName	Section name in Spanish
🏛 departmentCode	Issuing department code
🏢 departmentName	Issuing department name
🔖 epigraph	Epigraph grouping within the department, when present
📅 publicationDate	Publication date as YYYY-MM-DD
📰 diaryNumber	Daily diary number
🧷 summaryIdentifier	Identifier of the day's full summary
📄 pdfUrl	Link to the item PDF
🔗 htmlUrl	Link to the item HTML page
🧾 xmlUrl	Link to the item XML
🕒 scrapedAt	Timestamp the record was collected
❌ error	Null on success, message on failure

Sample records:

[
  {
    "identifier": "BOE-A-2024-87",
    "title": "Resolución de 21 de diciembre de 2023, de la Subsecretaría, por la que se resuelve la convocatoria de libre designación, efectuada por Resolución de 5 de septiembre de 2023.",
    "controlNumber": "2023/26904",
    "sectionCode": "2A",
    "sectionName": "II. Autoridades y personal. - A. Nombramientos, situaciones e incidencias",
    "departmentCode": "9562",
    "departmentName": "MINISTERIO DE ASUNTOS EXTERIORES, UNIÓN EUROPEA Y COOPERACIÓN",
    "epigraph": "Destinos",
    "publicationDate": "2024-01-02",
    "diaryNumber": "2",
    "summaryIdentifier": "BOE-S-2024-2",
    "pdfUrl": "https://www.boe.es/boe/dias/2024/01/02/pdfs/BOE-A-2024-87.pdf",
    "htmlUrl": "https://www.boe.es/diario_boe/txt.php?id=BOE-A-2024-87",
    "xmlUrl": "https://www.boe.es/diario_boe/xml.php?id=BOE-A-2024-87",
    "scrapedAt": "2026-06-05T16:43:06.033Z",
    "error": null
  }
]

✨ Why choose this Actor

• Keyless official source. Data comes straight from the Agencia Estatal BOE Open Data feed.
• Flat records. The nested daily tree is unwound so every item stands on its own row.
• Stable identifiers. The BOE-x-YYYY-N form lets you deduplicate and join across runs.
• Three document links per item, so you can grab the readable page or the machine readable XML.
• Empty days handled cleanly, so weekend and holiday gaps never break a range run.

📈 How it compares to alternatives

Approach	Structured records	Section filter	PDF, HTML and XML links	Setup
This Actor	Yes	Yes	Yes	None
Manual website browsing	No	Manual	Manual clicks	High effort
Parsing the raw summary yourself	Depends on your code	Build it	Build it	Heavy

🚀 How to use

1. Create a free Apify account using this sign-up link.
2. Open the Spain BOE Gazette Scraper.
3. Enter a single date, or a start and end date for a range.
4. Optionally pick the sections you care about and set a max items cap.
5. Run the Actor and collect your structured gazette records.

💼 Business use cases

Legal and regulatory monitoring

Need	How this helps
Catch new laws and decrees	Filter to section 1 and watch general provisions daily
Audit trail of official acts	Keep a dated archive of items with stable identifiers

Public procurement intelligence

Need	How this helps
Find new tenders	Filter to section 5A for public sector contracting notices
Feed a bid pipeline	Pull links to each tender document for review

Grants and subsidies

Need	How this helps
Spot new funding	Watch section 3 for aid and subsidy announcements
Notify applicants	Push fresh items to your team as they publish

Research and media

Need	How this helps
Build a gazette dataset	Collect ranges of days into one structured table
Reference original sources	Every record links to the official PDF and XML

🔌 Automating Spain BOE Gazette Scraper

Connect runs to the tools you already use:

• Make and Zapier to trigger workflows when new items appear.
• Slack to post fresh gazette items to a channel.
• Airbyte to sync records into a warehouse.
• GitHub to run on a schedule and commit snapshots.
• Google Drive to archive daily pulls.

🌟 Beyond business use cases

• Research: study legislative output and publication patterns over time.
• Personal: keep an eye on appointments or notices that affect you.
• Non-profit: track grants and public funding relevant to your cause.
• Experimentation: practice text analysis on a clean stream of official Spanish documents.

🤖 Ask an AI assistant

Drop a few records into your favorite assistant and ask it to summarize, classify or translate them:

• ChatGPT
• Claude
• Perplexity
• Microsoft Copilot

❓ Frequently Asked Questions

Is this an official BOE product? No. It is an independent tool that reads the public Open Data feed published by the Agencia Estatal BOE.

Do I need an API key? No. The BOE Open Data summary feed is keyless.

What date format does it expect? YYYYMMDD, for example 20240102.

Why did a date return no items? That day had no edition. The BOE skips Sundays and most public holidays.

How many items are in a typical day? A regular weekday often holds a few hundred items across all sections.

What is the identifier format? Items use the BOE-x-YYYY-N form, such as BOE-A-2024-87, which is stable across runs.

Can I collect a whole week at once? Yes. Set a start and end date and every day in the range is collected.

Can I limit which sections I get? Yes. Use the sections filter to keep only the codes you select.

Which document links are included? Each item carries links to its PDF, its HTML page and its XML.

How far back does the data go? The summary feed covers recent years. Test a known weekday in your target year to confirm coverage.

Is the title in Spanish? Yes. Titles are returned exactly as the BOE publishes them, in Spanish.

🔌 Integrate with any app

Every run produces a clean, flat table of records that drops straight into spreadsheets, databases, dashboards and automation platforms through the Apify API and integrations.

🔗 Recommended Actors

• EU Safety Gate RAPEX Scraper
• Estonia Business Register Scraper
• NZ Companies Register Scraper
• Bank of Canada Valet Scraper

💡 Pro Tip: browse the complete ParseForge collection.

🆘 Need Help? Open our contact form

⚠️ Disclaimer: independent tool, not affiliated with the Agencia Estatal BOE or the Government of Spain. Only publicly available data is collected.