# Spain datos.gob.es Catalog Scraper (`parseforge/spain-datos-gob-es-catalog-scraper`) Actor Tap the Spanish open data catalog at datos.gob.es and pull dataset records with id, title, publisher, theme, license, modified date, distribution URL, keywords, and territorial coverage. Filter by theme, publisher, or modified date for public sector research and analytics. - **URL**: https://apify.com/parseforge/spain-datos-gob-es-catalog-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $7.50 / 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 datos.gob.es Open Data Catalog Scraper > ๐Ÿš€ **Pull the Spanish national open data catalog in seconds. Datasets, distributions, themes, and publishers, straight from the official datos.gob.es DCAT-AP endpoint.** > ๐Ÿ•’ **Last updated** 2026-06-05 ยท **๐Ÿ“Š 11 fields** per record ยท 80,000+ datasets ยท 4,000+ publishers ยท DCAT-AP compliant The Spain datos.gob.es Open Data Catalog Scraper turns the official Iniciativa Aporta `apidata/catalog/dataset` endpoint into a clean dataset of open data resources. Filter by theme, publisher, or modification date, and the actor walks the paginated DCAT-AP response. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | ๐Ÿข Data engineers | Inventory all Spanish public datasets in your warehouse | | ๐Ÿ“ฐ Journalists | Discover datasets by theme for stories | | ๐ŸŽ“ Researchers | Build harvesting pipelines for academic work | | ๐Ÿ‘ฉโ€๐Ÿ’ป Civic tech | Power data portals on top of official metadata | ### ๐Ÿ“‹ What the Spain datos.gob.es Catalog Scraper does - Calls the official datos.gob.es DCAT-AP endpoint. - Paginates with `_pageSize` and `_page`, sorted by most recently modified. - Flattens multilingual titles to Spanish. - Picks the distribution matching your `format` filter when set. > ๐Ÿ’ก **Why it matters** datos.gob.es is the official aggregator of Spanish open data. The catalog is huge and DCAT-AP encoded. This actor flattens it. ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon._ ### โš™๏ธ Input
FieldTypeRequiredDescription
themeenumNoDCAT theme slug. Empty for all.
publisherstringNoOptional publisher slug.
formatenumNoDistribution format filter.
modifiedSincestringNoYYYY-MM-DD lower bound.
maxItemsintegerNoFree 10, paid up to 1,000,000.
**Example 1, environment datasets:** ```json { "theme": "medio-ambiente", "maxItems": 100 } ```` **Example 2, recent CSV releases:** ```json { "format": "CSV", "modifiedSince": "2025-01-01", "maxItems": 200 } ``` > โš ๏ธ **Good to Know** Public endpoint, no key required. Data is DCAT-AP encoded by the Spanish national open data office. ### ๐Ÿ“Š Output | Field | Type | Description | |---|---|---| | ๐Ÿ†” `id` | string | Persistent dataset identifier. | | ๐Ÿ“„ `title` | string | Title in Spanish. | | ๐Ÿข `publisher` | string | Issuing public body. | | ๐ŸŽฏ `theme` | string | DCAT theme. | | ๐Ÿ“œ `license` | string | Distribution license. | | ๐Ÿ•’ `modified` | string | Last modified date. | | ๐Ÿ“Ž `distributionUrl` | string | Direct link to the picked distribution. | | ๐Ÿ“ฆ `format` | string | Format of the picked distribution. | | ๐Ÿท๏ธ `keywords` | string | Comma joined keyword list. | | ๐ŸŒ `coverage` | string | Spatial or temporal coverage. | | ๐Ÿ•’ `scrapedAt` | string | When this row was fetched. | | โŒ `error` | string | Set on upstream error. | ### โœจ Why choose this Actor | ๐Ÿ†“ | Public DCAT-AP endpoint, no key. | | ๐Ÿ‡ช๐Ÿ‡ธ | All Spanish public bodies in one feed. | | ๐Ÿงน | Multilingual fields flattened to Spanish. | | ๐Ÿ›Ÿ | Errors surface as a clean record. | ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Setup | DCAT flatten | Format picker | |---|---|---|---| | Roll your own fetch | 30 min plus | โŒ | โŒ | | **This Actor** | 5 sec | โœ… | โœ… | ### ๐Ÿš€ How to use 1. Click **Try for free**. 2. Pick a theme or leave empty. 3. Click **Start**. ### ๐Ÿ’ผ Business use cases **๐Ÿข Data inventory** Mirror the national catalog into your warehouse. **๐Ÿ“ฐ Newsroom** Find datasets by theme for stories. **๐ŸŽ“ Research** Build harvesting pipelines. **๐Ÿค– ML** Train classifiers on open data metadata. ### ๐Ÿ”Œ Automating Spain datos.gob.es Catalog Scraper - **Make and Zapier** weekly catalog snapshot. - **Cron** Apify scheduler. - **Webhooks** on completion. - **Warehouses** pipe to BigQuery or Snowflake. ### ๐ŸŒŸ Beyond business use cases **๐ŸŽ“ Education** Use real DCAT-AP data in courses. **๐Ÿงช Personal research** Discover datasets in your region. **๐Ÿค Non-profit** Power open-data discovery sites. **๐Ÿงฐ Tinkering** Prototype harvesting pipelines. ### ๐Ÿค– Ask an AI assistant about this scraper Paste this README into ChatGPT, Claude, or any assistant. ### โ“ Frequently Asked Questions **โ“ Do I need a key** No. **โ“ How big is the catalog** 80,000+ datasets across 4,000+ publishers. **โ“ Which languages** Titles flattened to Spanish. **โ“ How fresh** Daily updates from the Aporta initiative. **โ“ Can I filter by format** Yes, via the `format` enum. **โ“ Is this scraping** No, official DCAT-AP API. ### ๐Ÿ”Œ Integrate with any app Apify ships native integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, and any REST endpoint or webhook. ### ๐Ÿ”— Recommended Actors | Actor | What it does | |---|---| | [ParseForge GovInfo Scraper](https://apify.com/parseforge/govinfo-publications-scraper) | US federal publications. | | [ParseForge Swiss BAG Scraper](https://apify.com/parseforge/swiss-bag-infectious-diseases-scraper) | Swiss notifiable diseases. | | [ParseForge OurAirports Scraper](https://apify.com/parseforge/ourairports-scraper) | Global airport database. | > ๐Ÿ’ก **Pro Tip** browse the complete [ParseForge collection](https://apify.com/parseforge). *** **Disclaimer** This actor uses only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp). # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `theme` (type: `string`): DCAT theme slug (e.g. medio-ambiente, sector-publico, transporte). Empty for all. ## `publisher` (type: `string`): Optional publisher org slug (e.g. e05068001). ## `format` (type: `string`): Optional distribution format filter. ## `modifiedSince` (type: `string`): Only datasets modified on or after this date. ## Actor input object example ```json { "maxItems": 10, "theme": "", "format": "" } ``` # 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 = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/spain-datos-gob-es-catalog-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 = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("parseforge/spain-datos-gob-es-catalog-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 '{ "maxItems": 10 }' | apify call parseforge/spain-datos-gob-es-catalog-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/spain-datos-gob-es-catalog-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spain datos.gob.es Catalog Scraper", "description": "Tap the Spanish open data catalog at datos.gob.es and pull dataset records with id, title, publisher, theme, license, modified date, distribution URL, keywords, and territorial coverage. Filter by theme, publisher, or modified date for public sector research and analytics.", "version": "0.1", "x-build-id": "w9mafbTFry53oN3Vo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~spain-datos-gob-es-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-spain-datos-gob-es-catalog-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-datos-gob-es-catalog-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-spain-datos-gob-es-catalog-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-datos-gob-es-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-spain-datos-gob-es-catalog-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": { "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" }, "theme": { "title": "Theme", "enum": [ "", "ciencia-tecnologia", "comercio", "cultura-ocio", "demografia", "deporte", "economia", "educacion", "empleo", "energia", "hacienda", "industria", "legislacion-justicia", "medio-ambiente", "medio-rural-pesca", "salud", "sector-publico", "seguridad", "sociedad-bienestar", "transporte", "turismo", "urbanismo-infraestructuras", "vivienda" ], "type": "string", "description": "DCAT theme slug (e.g. medio-ambiente, sector-publico, transporte). Empty for all.", "default": "" }, "publisher": { "title": "Publisher", "type": "string", "description": "Optional publisher org slug (e.g. e05068001)." }, "format": { "title": "Distribution format", "enum": [ "", "CSV", "JSON", "XML", "RDF", "XLS", "XLSX", "GEOJSON", "SHP", "HTML", "PDF" ], "type": "string", "description": "Optional distribution format filter.", "default": "" }, "modifiedSince": { "title": "Modified since (YYYY-MM-DD)", "type": "string", "description": "Only datasets modified on or after this date." } } }, "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 } } } } } } } } } } ```