{
"openapi": "3.0.1",
"info": {
"title": "EU CORDIS API — Horizon Europe & H2020 Scraper",
"description": "EU CORDIS API scraper for Horizon Europe and Horizon 2020 grant projects. Exports funding amounts, coordinator, participants, programme, dates, and objectives as structured JSON. Four input modes, 20 fields per row.",
"version": "0.3",
"x-build-id": "gbuSwVq58oSdkKCkB"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~eu-cordis-grants/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-eu-cordis-grants",
"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/devilscrapes~eu-cordis-grants/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-eu-cordis-grants",
"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/devilscrapes~eu-cordis-grants/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-eu-cordis-grants",
"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": {
"projectIds": {
"title": "Project IDs",
"type": "array",
"description": "Explicit CORDIS project IDs to fetch (e.g. 101069357). Exactly one of projectIds, searchQuery, programmeFilter, or countryFilter must be provided.",
"items": {
"type": "string"
}
},
"searchQuery": {
"title": "Free-text search",
"type": "string",
"description": "Free-text query against the CORDIS search index (e.g. quantum computing or hydrogen storage). 1-500 chars."
},
"programmeFilter": {
"title": "Programme filter",
"type": "string",
"description": "Programme code, e.g. HORIZON.2.5 (Climate, Energy and Mobility) or H2020-EU.1.1. (ERC)."
},
"countryFilter": {
"title": "Coordinator country (ISO-2)",
"type": "string",
"description": "ISO 3166-1 alpha-2 of the coordinator country (e.g. DE, ES, NL). Lower-case is normalised to upper. Implemented as a post-filter on search results — pagination may scan more API pages than maxProjects to collect that many matching rows."
},
"framework": {
"title": "Framework programme",
"enum": [
"HORIZON",
"H2020",
"ANY"
],
"type": "string",
"description": "Restrict to one framework programme or search both. Ignored when projectIds mode is used.",
"default": "HORIZON"
},
"maxProjects": {
"title": "Max projects",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Max ResultRows emitted in list modes (search, programme, country). Ignored when projectIds mode is used.",
"default": 100
},
"includeFullAbstract": {
"title": "Include full objective",
"type": "boolean",
"description": "Deep-fetch the project detail HTML page to extract the untruncated objective text. Adds one extra request per row and switches PPE event from result-row ($0.003) to result-row-detailed ($0.005).",
"default": false
},
"useProxy": {
"title": "Use Apify Proxy",
"type": "boolean",
"description": "Route requests through Apify Proxy (BUYPROXIES94952). CORDIS does not currently rate-limit datacenter IPs; leave off unless you see 429.",
"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
}
}
}
}
}
}
}
}
}
}