{ "openapi": "3.0.1", "info": { "title": "Basque Country Tenders Scraper — Euskadi Public Contracts", "description": "Scrape the Basque Country public procurement announcements index (Basque Government, provincial councils and town halls) from the official Open Data Euskadi catalogue. Anuncios de contratación pública del País Vasco, con volcado anual o solo anuncios en plazo.", "version": "0.1", "x-build-id": "QLOskVImUORb8Yhow" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xamto1987~euskadi-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xamto1987-euskadi-tenders", "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/xamto1987~euskadi-tenders/runs": { "post": { "operationId": "runs-sync-xamto1987-euskadi-tenders", "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/xamto1987~euskadi-tenders/run-sync": { "post": { "operationId": "run-sync-xamto1987-euskadi-tenders", "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": { "fuente": { "title": "Source / Fuente", "enum": [ "abiertos", "anio" ], "type": "string", "description": "'abiertos' (default) = only the announcements CURRENTLY open for bids (small dump, refreshed daily, fast run). 'anio' = the full historical dump of one year (set in 'anio'), much larger (tens of thousands of rows) and including already closed and awarded announcements. / ES: solo anuncios en plazo, o volcado histórico anual completo.", "default": "abiertos" }, "anio": { "title": "Year (only when fuente=anio) / Año", "minimum": 2005, "maximum": 2026, "type": "integer", "description": "Year of the historical dump to download. Available from 2005. Ignored when 'fuente' is 'abiertos'. WARNING: recent yearly dumps have tens of thousands of rows (the 2025 file weighs ~230 MB): the run can take several minutes just to download the file. / ES: año del volcado histórico; los recientes son muy grandes.", "default": 2025 }, "keywords": { "title": "Keywords / Palabras clave", "type": "array", "description": "Terms to search for in the contract title and object. WARNING: CLIENT-SIDE filter — this source offers no server-side search parameters (verified with curl: it exposes no '?q='). Empty = no filter. / ES: filtro en cliente; esta fuente no ofrece búsqueda en servidor.", "default": [], "items": { "type": "string" } }, "soloContratoMenor": { "title": "Minor contracts only / Solo contratos menores", "type": "boolean", "description": "Client-side filter keeping only announcements flagged as a minor (direct-award) contract by the source itself. / ES: filtro en cliente para contratos menores.", "default": false }, "fechaDesde": { "title": "Date from / Fecha desde", "type": "string", "description": "Only announcements published on or after this date (CLIENT-SIDE filter, ISO format 'YYYY-MM-DD'). / ES: filtro de fecha en cliente, formato ISO." }, "fechaHasta": { "title": "Date to / Fecha hasta", "type": "string", "description": "Only announcements published up to this date (CLIENT-SIDE filter, ISO format 'YYYY-MM-DD'). / ES: filtro de fecha en cliente, formato ISO." }, "maxItems": { "title": "Max items / Máximo de resultados", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Hard cap on the number of announcements saved to the dataset. The Actor stops cleanly when it is reached. / ES: tope de anuncios del dataset.", "default": 200 } } }, "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 } } } } } } } } } }