{ "openapi": "3.0.1", "info": { "title": "Spain Grants Registries Scraper (BDNS)", "description": "Registros especiales de la Base de Datos Nacional de Subvenciones: grandes beneficiarios, sanciones por fraude en subvenciones y ayudas a partidos politicos. Spanish big grant recipients, subsidy fraud sanctions and political party grants.", "version": "0.1", "x-build-id": "Zcy0nqFdgo24lFmHQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xamto1987~spain-grants-registries/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xamto1987-spain-grants-registries", "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~spain-grants-registries/runs": { "post": { "operationId": "runs-sync-xamto1987-spain-grants-registries", "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~spain-grants-registries/run-sync": { "post": { "operationId": "run-sync-xamto1987-spain-grants-registries", "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", "required": [ "registro" ], "properties": { "registro": { "title": "Registro / Register", "enum": [ "grandes_beneficiarios", "sanciones", "partidos_politicos" ], "type": "string", "description": "Que registro especial de la BDNS se extrae. `grandes_beneficiarios` = perceptores de mas ayuda publica acumulada por ano (agregado anual, ordenado de mayor a menor). `sanciones` = empresas sancionadas por fraude en subvenciones (registro MUY pequeno a nivel nacional: unas pocas decenas de filas en total). `partidos_politicos` = subvenciones a partidos y grupos municipales. / Which BDNS special register to scrape.", "default": "grandes_beneficiarios" }, "keywords": { "title": "Palabras clave / Keywords", "type": "array", "description": "Filtra por nombre/NIF del beneficiario. En `sanciones` y `partidos_politicos` se busca en servidor sobre el titulo de la convocatoria de origen (una consulta por termino). En `grandes_beneficiarios` el servidor IGNORA este filtro (verificado en fase 5) y se aplica EN CLIENTE sobre nombre/NIF del beneficiario, lo que implica recorrer mas paginas. Vacio = sin filtro. / Server-side for sanciones/partidos_politicos; client-side for grandes_beneficiarios.", "default": [], "items": { "type": "string" } }, "fechaDesde": { "title": "Fecha desde / Date from", "type": "string", "description": "Solo aplica a `sanciones` y `partidos_politicos` (fecha de sancion / de concesion). `grandes_beneficiarios` es un agregado ANUAL sin fecha de concesion: este filtro se ignora para ese registro. / Only applies to sanciones and partidos_politicos." }, "maxItems": { "title": "Maximo de resultados / Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Numero maximo de items a guardar en el dataset. El actor para limpiamente al alcanzarlo. / Hard cap on dataset items.", "default": 200 }, "includePersonalData": { "title": "Incluir beneficiarios persona fisica / Include individual beneficiaries", "type": "boolean", "description": "DESACTIVADO POR DEFECTO. Con esta opcion desactivada se excluyen los beneficiarios que son personas fisicas (DNI/NIE, o NIF enmascarado) y el dataset contiene unicamente empresas, entidades y administraciones. En `grandes_beneficiarios` esto tambien excluye por precaucion algunas entidades internacionales cuyo codigo no sigue el formato NIF espanol (no se pueden clasificar con certeza como persona juridica). Activarlo hace que el dataset pueda incluir datos personales: su tratamiento posterior es responsabilidad tuya (RGPD / LOPDGDD). / OFF by default: individual (natural person) beneficiaries are excluded.", "default": false } } }, "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 } } } } } } } } } }