{ "openapi": "3.0.1", "info": { "title": "Spain Official Gazette (BOE) to JSON — grants, tax, public jobs", "description": "Every item of Spain's Official State Gazette (BOE) as clean JSON for AI agents, RAG and alerts: title, legal rank, ministry, section, PDF/HTML/XML links and topic tags (grants, tax, public jobs, procurement, housing, labour, energy). Official open-data API, no login, one day or a date range.", "version": "0.0", "x-build-id": "VUwHIRgq7VZxto8lu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lif_manager~spain-boe-official-gazette-json/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lif_manager-spain-boe-official-gazette-json", "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/lif_manager~spain-boe-official-gazette-json/runs": { "post": { "operationId": "runs-sync-lif_manager-spain-boe-official-gazette-json", "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/lif_manager~spain-boe-official-gazette-json/run-sync": { "post": { "operationId": "run-sync-lif_manager-spain-boe-official-gazette-json", "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": { "dateFrom": { "title": "From date", "type": "string", "description": "First day (YYYY-MM-DD). Leave both dates empty for a free demo with the latest issue." }, "dateTo": { "title": "To date", "type": "string", "description": "Last day (YYYY-MM-DD). Up to 31 days per run. Empty = same as From date." }, "latest": { "title": "Latest issue (charged)", "type": "boolean", "description": "With no dates: deliver the whole latest issue instead of the 10-item demo.", "default": false }, "topics": { "title": "Topics", "type": "array", "description": "Keep only items with any of these tags (keyword-based, may miss or over-match).", "items": { "type": "string", "enum": [ "ayudas_subvenciones", "fiscal", "empleo_publico", "contratacion_publica", "vivienda_accesibilidad", "laboral", "energia" ], "enumTitles": [ "Grants & subsidies", "Tax", "Public jobs", "Public procurement", "Housing & accessibility", "Labour & social security", "Energy" ] } }, "keyword": { "title": "Keyword", "type": "string", "description": "Case-insensitive text that must appear in the title or ministry, e.g. 'IVA' or 'Madrid'." }, "sections": { "title": "Sections", "type": "array", "description": "BOE section codes: 1, 2A, 2B, 3, 4, 5A, 5B, 5C, T.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Part of the ministry or body name, e.g. 'HACIENDA'.", "items": { "type": "string" } }, "fullText": { "title": "Include full text (for RAG)", "type": "boolean", "description": "Also download each item's official XML and add the full text as clean paragraphs, the BOE's own subject tags (materias), ELI link and dates. Charged as 'Item with full text' instead of 'Item'.", "default": false }, "maxItems": { "title": "Max items", "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 } } } } } } } } } }