{ "openapi": "3.0.1", "info": { "title": "BOE Alerts API: Spanish Gazette by Keyword", "description": "Monitor Spain's Boletín Oficial del Estado (BOE) with named keyword rules. Get only new entries since your last run, classified as grants, public jobs, regulations or contracts, plus a daily digest. No login.", "version": "0.2", "x-build-id": "unIKP1t0cskCbKjSr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oatpage~boe-sumario-reader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oatpage-boe-sumario-reader", "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/oatpage~boe-sumario-reader/runs": { "post": { "operationId": "runs-sync-oatpage-boe-sumario-reader", "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/oatpage~boe-sumario-reader/run-sync": { "post": { "operationId": "run-sync-oatpage-boe-sumario-reader", "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": "Date from", "type": "string", "description": "First publication date (YYYY-MM-DD). Defaults to today (Madrid time)." }, "dateTo": { "title": "Date to", "type": "string", "description": "Last publication date (YYYY-MM-DD). Defaults to dateFrom. Maximum range: 92 days." }, "sections": { "title": "BOE sections", "type": "array", "description": "Section codes to include: 1, 2A, 2B, 3, 4, 5A, 5B, 5C. Leave empty for all sections.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords (title filter)", "type": "array", "description": "Only items whose title contains at least one keyword (case and accent insensitive). Leave empty for no filter.", "default": [], "items": { "type": "string" } }, "department": { "title": "Department contains", "type": "string", "description": "Only items whose issuing department name contains this text (case and accent insensitive), e.g. 'Hacienda'." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of items to output (and be charged for).", "default": 100 }, "watches": { "title": "Alerts (named watches)", "type": "array", "description": "Optional. Several named alert rules in one run. Each rule: {\"name\":\"...\",\"keywords\":[any of these in the title],\"mustInclude\":[all of these],\"exclude\":[none of these],\"sections\":[\"1\",\"3\"],\"categories\":[\"subvenciones_ayudas\"],\"department\":\"hacienda\"} with at least one criterion. Only items matching at least one rule are returned, each with the list of rules it matched in 'alerts'." }, "categories": { "title": "Categories", "type": "array", "description": "Optional. Keep only these categories: normativa, subvenciones_ayudas, empleo_publico, convenios_colectivos, convenios_administrativos, contratacion, nombramientos, justicia, anuncios, otras_disposiciones.", "default": [], "items": { "type": "string" } }, "onlyNewSinceLastRun": { "title": "Alerts: only what is new since my last run", "type": "boolean", "description": "Remembers the last BOE date processed (per 'Watch name') and reads only the days after it up to today. Schedule it daily. If more items match than 'Max items', the position is not advanced so nothing is lost.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of this alert stream, for the remembered position. Use a different one for each stream you follow.", "default": "default" }, "includeDigest": { "title": "Include digest record", "type": "boolean", "description": "Adds one record (type 'digest') with the number of matching items by category and the departments with most items. Not billed.", "default": true } } }, "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 } } } } } } } } } }