# Spain BOE Gazette Scraper (`parseforge/spain-boe-gazette-scraper`) Actor Pull the daily summary of Spain official gazette BOE by date or range. Each item arrives flat with its BOE identifier, Spanish title, section, issuing department, publication date, and links to the document. Handy for legal monitoring, tender tracking, and grant research. - **URL**: https://apify.com/parseforge/spain-boe-gazette-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Automation, Developer tools, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## 🇪🇸 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: ```json { "date": "20240102", "maxItems": 50 } ```` Date range, only general provisions and other dispositions: ```json { "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: ```json [ { "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](https://console.apify.com/sign-up?fpr=vmoqkp). 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](https://chat.openai.com) - [Claude](https://claude.ai) - [Perplexity](https://www.perplexity.ai) - [Microsoft Copilot](https://copilot.microsoft.com) ### ❓ 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](https://apify.com/parseforge) - [Estonia Business Register Scraper](https://apify.com/parseforge) - [NZ Companies Register Scraper](https://apify.com/parseforge) - [Bank of Canada Valet Scraper](https://apify.com/parseforge) > 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge). **🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **⚠️ Disclaimer:** independent tool, not affiliated with the Agencia Estatal BOE or the Government of Spain. Only publicly available data is collected. # Actor input Schema ## `date` (type: `string`): Single publication date to collect, as YYYYMMDD (for example 20240102). Used when no date range is provided. Weekends and public holidays are usually empty. ## `startDate` (type: `string`): First publication date of a range, as YYYYMMDD. When both Start Date and End Date are set, every day in the range is collected and the single Date above is ignored. ## `endDate` (type: `string`): Last publication date of a range, as YYYYMMDD (inclusive). Must be on or after Start Date. ## `sections` (type: `array`): Limit collection to specific BOE sections. Leave empty to collect every section of each day. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "date": "20240102", "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "date": "20240102", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/spain-boe-gazette-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "date": "20240102", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/spain-boe-gazette-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "date": "20240102", "maxItems": 10 }' | apify call parseforge/spain-boe-gazette-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/spain-boe-gazette-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spain BOE Gazette Scraper", "description": "Pull the daily summary of Spain official gazette BOE by date or range. Each item arrives flat with its BOE identifier, Spanish title, section, issuing department, publication date, and links to the document. Handy for legal monitoring, tender tracking, and grant research.", "version": "0.1", "x-build-id": "gZfF9XsPRnvIjtqWa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~spain-boe-gazette-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-spain-boe-gazette-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~spain-boe-gazette-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-spain-boe-gazette-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~spain-boe-gazette-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-spain-boe-gazette-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "date": { "title": "Date", "type": "string", "description": "Single publication date to collect, as YYYYMMDD (for example 20240102). Used when no date range is provided. Weekends and public holidays are usually empty." }, "startDate": { "title": "Start Date", "type": "string", "description": "First publication date of a range, as YYYYMMDD. When both Start Date and End Date are set, every day in the range is collected and the single Date above is ignored." }, "endDate": { "title": "End Date", "type": "string", "description": "Last publication date of a range, as YYYYMMDD (inclusive). Must be on or after Start Date." }, "sections": { "title": "Sections", "type": "array", "description": "Limit collection to specific BOE sections. Leave empty to collect every section of each day.", "items": { "type": "string", "enum": [ "1", "2A", "2B", "3", "4", "5A", "5B", "5C" ], "enumTitles": [ "1 — I. Disposiciones generales", "2A — II. Autoridades y personal. Nombramientos, situaciones e incidencias", "2B — II. Autoridades y personal. Oposiciones y concursos", "3 — III. Otras disposiciones", "4 — IV. Administración de Justicia", "5A — V. Anuncios. Contratación del Sector Público", "5B — V. Anuncios. Otros anuncios oficiales", "5C — V. Anuncios. Anuncios particulares" ] } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```