BOPV Scraper — Basque Country Official Gazette

Scrape all disposiciones (regulations, grants, tenders, appointments) from the Boletín Oficial del País Vasco (BOPV) at euskadi.eus. Extract structured data from official XML bulletin summaries with keyword and section filters.

No browser required. Parses official XML files directly — lightweight, fast, and reliable.

Why use this scraper

• Official source — pulls directly from the Basque Government's XML bulletin summaries at euskadi.eus
• Complete coverage — captures every disposición: regulations, grants, subsidies, appointments, public tenders, and administrative notices
• Keyword filtering — search for specific topics like "subvención", "licitación", "educación", or any term in the title
• Section filtering — narrow results to specific sections (Autoridades y Personal, Disposiciones Generales, Otras Disposiciones, etc.)
• Fast and cheap — processes 500+ items in under 20 seconds at ~$0.01 per run
• Direct links — each result includes a link to the full text on euskadi.eus

Use cases

• Grant and subsidy monitoring — track new subvenciones and ayudas published by Basque Government departments
• Regulatory intelligence — monitor new laws, decrees, and orders affecting your industry in Euskadi
• Public tender discovery — find procurement opportunities published in the BOPV
• HR and appointments tracking — follow staffing changes across Osakidetza, UPV/EHU, and government departments
• Legal compliance — stay updated on regulatory changes relevant to businesses operating in the Basque Country
• Academic research — bulk download gazette data for political science, legal, or public administration research

Input parameters

Parameter	Description	Default
monthsBack	How many months of bulletins to fetch	3
keyword	Keyword filter on title (case-insensitive)	all
seccionFilter	Filter by section name (partial match)	all
maxItems	Maximum items to return (0 = unlimited)	0

Output fields

Field	Description
boletin	Bulletin number (sequential within year)
anio	Year
mes	Month
seccion	Section name (e.g. AUTORIDADES Y PERSONAL, OTRAS DISPOSICIONES)
subseccion	Subsection name
organismo	Issuing body (e.g. DEPARTAMENTO DE EDUCACIÓN, OSAKIDETZA)
titulo	Full title of the disposición
orden	Order number within the bulletin
link	Direct link to the full text on euskadi.eus
source	Data source identifier (bopv)

Example input

{
  "monthsBack": 6,
  "keyword": "subvención",
  "seccionFilter": "autoridades"
}

Example output

{
  "boletin": 1,
  "anio": 2026,
  "mes": 1,
  "seccion": "OTRAS DISPOSICIONES",
  "subseccion": "",
  "organismo": "DEPARTAMENTO DE EDUCACIÓN",
  "titulo": "ORDEN de 4 de diciembre de 2025, de la consejera de Educación, por la que se autoriza la ampliación de especialidades de música a la Escuela de Música Pública «Jesús Arambarri», de Bilbao (Bizkaia).",
  "orden": "2",
  "link": "https://www.euskadi.eus/web01-bopv/es/bopv2/datos/2026/01/2600002a.shtml",
  "source": "bopv"
}

Cost estimation

Scenario	Months	Items	Duration	Estimated cost
Quick check	1	~500	~4s	~$0.002
Quarter scan	3	~1,500	~19s	~$0.01
Full year	12	~6,000	~60s	~$0.03

Memory: 4,096 MB (default). Could run on less since it's XML-only.

Common keyword searches

Keyword	What you'll find
subvención	Grant and subsidy announcements
licitación	Public tender notices
convocatoria	Calls for applications (jobs, grants, exams)
decreto	Government decrees
nombramiento	Appointments and staffing
osakidetza	Basque health service notices
educación	Education-related disposiciones

Notes

• Bulletin numbering is sequential within the year (~245 bulletins/year, Mon–Fri)
• The scraper auto-discovers the current bulletin from the official Ultimo.xml endpoint
• XML files are encoded in ISO-8859-1
• No proxy required — datacenter IPs work fine
• For continuous monitoring, schedule daily runs via the Apify Scheduler