Spanish Official Gazette Scraper -- BOE Laws & Decrees

Extract laws, royal decrees, appointments, public procurement notices, and official announcements from Spain's Boletin Oficial del Estado (BOE). Filter by date range, section, department, or keyword. Returns structured data with direct links to PDF, HTML, and XML documents. No cookies, no login required.

How to scrape BOE data

This actor queries the official BOE Open Data API to deliver structured Spanish gazette data. The BOE is Spain's mandatory publication channel for all legislation, government appointments, public procurement, and official notices. Published daily (Monday through Saturday), the BOE is the definitive legal record of the Spanish state.

Search by keyword

Search in Spanish for best results. Examples: "vivienda" (housing), "empleo" (employment), "impuesto" (tax), "energia" (energy), "educacion" (education). The keyword filter matches against document titles and headings.

Filter by section

The BOE is organized into sections:

Section	Content
I	General provisions -- laws, royal decrees, ministerial orders
II.A	Appointments, promotions, transfers of civil servants
II.B	Public exams and competitive positions (oposiciones)
III	Other provisions -- subsidies, grants, regional regulations
IV	Administration of Justice
V.A	Public procurement announcements
V.B	Other official announcements
V.C	Private announcements

Filter by department

Narrow results to a specific ministry or institution: "HACIENDA" (Finance), "DEFENSA" (Defense), "INTERIOR", "TRABAJO" (Labor), "EDUCACION" (Education). Partial match, case-insensitive.

Date range monitoring

Set a date range to monitor specific periods. The BOE publishes Monday through Saturday (no Sunday edition). Perfect for daily or weekly monitoring of new regulations.

What data does BOE Scraper extract?

Field	Type	Description
identificador	String	BOE document ID (e.g., BOE-A-2026-10986)
titulo	String	Full document title in Spanish
seccion	String	BOE section name
departamento	String	Issuing department or ministry
epigrafe	String	Subject heading (e.g., "Medidas urgentes")
fechaPublicacion	String	Publication date (YYYY-MM-DD)
numeroDiario	String	Daily issue number
urlPdf	String	Direct PDF download link
urlHtml	String	HTML version link
urlXml	String	XML version link
paginaInicial	String	Starting page in the printed edition
paginaFinal	String	Ending page in the printed edition
control	String	Internal reference number
url	String	Direct link to BOE document
scrapedAt	String	ISO timestamp of extraction

Example output

{
    "identificador": "BOE-A-2026-10986",
    "titulo": "Resolucion de 20 de mayo de 2026, del Congreso de los Diputados, por la que se ordena la publicacion del Acuerdo de convalidacion del Real Decreto-ley 10/2026",
    "seccion": "I. Disposiciones generales",
    "departamento": "CORTES GENERALES",
    "epigrafe": "Medidas urgentes",
    "fechaPublicacion": "2026-05-22",
    "numeroDiario": "125",
    "urlPdf": "https://www.boe.es/boe/dias/2026/05/22/pdfs/BOE-A-2026-10986.pdf",
    "urlHtml": "https://www.boe.es/diario_boe/txt.php?id=BOE-A-2026-10986",
    "urlXml": "https://www.boe.es/diario_boe/xml.php?id=BOE-A-2026-10986",
    "paginaInicial": "69602",
    "paginaFinal": "69602",
    "control": "2026/8251",
    "url": "https://www.boe.es/diario_boe/txt.php?id=BOE-A-2026-10986",
    "scrapedAt": "2026-05-23T10:00:00.000Z"
}

Use cases

• Legal compliance monitoring -- Track new regulations affecting your industry by section and keyword.
• Public procurement -- Monitor section V.A for new government contract opportunities.
• HR and recruitment -- Follow section II.B for public exam announcements (oposiciones).
• Academic research -- Build a corpus of Spanish legislation over time.
• Government affairs -- Track ministerial appointments and institutional changes.

Tips for best results

• Daily monitoring: Set dateFrom and dateTo to the same date for a single day's gazette.
• Multi-day scan: Use a date range to catch up on recent publications.
• Procurement focus: Set section to "5A" to only see public procurement announcements.
• Scheduled runs: Run daily to build a comprehensive database of Spanish legislation.

How much does it cost?

Search size	Estimated time	Estimated cost
1 day (20-80 items)	~3 seconds	~$0.002
1 week (~200 items)	~10 seconds	~$0.008
1 month (~1,000 items)	~1 minute	~$0.05

Can I use it as an API?

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("studio-amba/boe-scraper").call(run_input={
    "searchQuery": "vivienda",
    "section": "1",
    "dateFrom": "2026-05-01",
    "dateTo": "2026-05-22",
    "maxResults": 50,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['identificador']} | {item['titulo'][:80]}")

Limitations

• The BOE API returns summaries by date. Keyword filtering is done client-side after fetching.
• No Sunday editions -- the BOE is not published on Sundays.
• Very large date ranges (months) will make many API calls; use maxResults to cap output.

Other Spanish data scrapers

• Subastas BOE Scraper -- Spanish government & judicial auctions
• BOAMP Scraper -- French public procurement tenders

Your feedback

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