{ "openapi": "3.0.1", "info": { "title": "EU Funds Beneficiaries API: Kohesio Projects & Budgets", "description": "EU funds beneficiaries API on Kohesio, the European Commission project database: find EU cohesion policy projects with beneficiary, country, region, fund, programme, EU contribution, total budget and dates. Filter by keyword, country, budget and year, or monitor new projects. Pay per project.", "version": "0.0", "x-build-id": "13qUk5fjwXg3I7kxr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tiger19935~eu-funds-beneficiaries/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tiger19935-eu-funds-beneficiaries", "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/tiger19935~eu-funds-beneficiaries/runs": { "post": { "operationId": "runs-sync-tiger19935-eu-funds-beneficiaries", "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/tiger19935~eu-funds-beneficiaries/run-sync": { "post": { "operationId": "run-sync-tiger19935-eu-funds-beneficiaries", "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": { "mode": { "title": "Mode", "enum": [ "search", "lookup", "monitor", "selftest" ], "type": "string", "description": "What to do. `search` - find EU-funded projects by keyword, country, beneficiary, budget, year `lookup` - full details of projects by Kohesio id `monitor` - report only new or changed projects `selftest` - health check (for schedules)", "default": "search" }, "keyword": { "title": "Keyword", "type": "string", "description": "e.g. 'solar', 'school', 'digital'.", "default": "solar" }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter codes, e.g. PL, DE, RO.", "items": { "type": "string" } }, "beneficiaryName": { "title": "Beneficiary contains", "type": "string", "description": "Part of the beneficiary name (requires a detail lookup per project)." }, "regionContains": { "title": "Region contains", "type": "string", "description": "Part of the region or country name." }, "minBudget": { "title": "Minimum EU contribution (EUR)", "type": "number", "description": "EU contribution from." }, "maxBudget": { "title": "Maximum EU contribution (EUR)", "type": "number", "description": "EU contribution up to." }, "yearFrom": { "title": "Start year from", "type": "integer", "description": "Project start year from." }, "yearTo": { "title": "Start year to", "type": "integer", "description": "Project start year to." }, "fetchBeneficiary": { "title": "Fetch beneficiary and region", "type": "boolean", "description": "Adds beneficiary, fund, programme and region (one extra request per project).", "default": true }, "projectIds": { "title": "Project IDs", "type": "array", "description": "Lookup mode: Kohesio ids such as Q4418451.", "items": { "type": "string" } }, "emitBaseline": { "title": "Emit baseline (monitor)", "type": "boolean", "description": "Report all current matches on the first monitor run.", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many billable results (a spending cap per run).", "default": 50 } } }, "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 } } } } } } } } } }