{ "openapi": "3.0.1", "info": { "title": "Spain BOE Legislation Scraper", "description": "Get new Spanish laws, royal decrees, orders and resolutions from the official BOE open data API. Filter by keyword, department and legal rank. Legal metadata and optional full text for AI and legal research.", "version": "0.0", "x-build-id": "3g6yZaxlcj34rHhvX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spain-data~spain-boe-legislation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spain-data-spain-boe-legislation", "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/spain-data~spain-boe-legislation/runs": { "post": { "operationId": "runs-sync-spain-data-spain-boe-legislation", "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/spain-data~spain-boe-legislation/run-sync": { "post": { "operationId": "run-sync-spain-data-spain-boe-legislation", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Only return items whose title or heading contains at least one of these words (Spanish, accents ignored). Example: protección de datos, vivienda, IRPF.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Skip items containing any of these words.", "items": { "type": "string" } }, "sections": { "title": "BOE sections", "type": "array", "description": "Section I contains laws, royal decrees and ministerial orders. Section III contains other provisions: collective agreements, grants, agreements, court rulings, etc.", "items": { "type": "string", "enum": [ "1", "3" ], "enumTitles": [ "I. General provisions (laws, decrees, orders)", "III. Other provisions" ] }, "default": [ "1", "3" ] }, "departments": { "title": "Issuing departments", "type": "array", "description": "Filter by issuing body (partial match, accents ignored). Example: Hacienda, Trabajo, Tribunal Constitucional, Comunidad Autónoma de Cataluña.", "items": { "type": "string" } }, "ranks": { "title": "Legal rank", "type": "array", "description": "Filter by type of provision, e.g. Ley, Ley Orgánica, Real Decreto, Real Decreto-ley, Orden, Resolución, Circular.", "items": { "type": "string" } }, "lastIssues": { "title": "Latest issues", "minimum": 1, "maximum": 25, "type": "integer", "description": "Number of most recent BOE issues to process (days without a BOE, such as Sundays, are skipped). Ignored if a date range is set. Use 1 for a daily schedule.", "default": 1 }, "startDate": { "title": "Start date", "type": "string", "description": "Optional. Process every BOE from this date (YYYY-MM-DD). Max range: 1 year." }, "endDate": { "title": "End date", "type": "string", "description": "Optional. Last date of the range (defaults to today)." }, "includeDetails": { "title": "Include legal metadata", "type": "boolean", "description": "Adds rank, official number, dates of approval and entry into force, repeal status, ELI identifier, subject matters and references (repeals, amends, transposes...).", "default": true }, "includeFullText": { "title": "Include full text", "type": "boolean", "description": "Adds the complete text of each provision. Ideal for AI, RAG and legal analysis.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many items.", "default": 1000 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }