{ "openapi": "3.0.1", "info": { "title": "IEA Energy Data (SDG7 & energy indicators)", "description": "Query any indicator in the public IEA indicator catalogue by country and year, with a free indicator list, flow and product dimensions, provenance and source age. Includes batch, HTTP and MCP access.", "version": "0.2", "x-build-id": "838yMDogaGY1cef5g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aitorsm~iea-energy-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aitorsm-iea-energy-data", "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/aitorsm~iea-energy-data/runs": { "post": { "operationId": "runs-sync-aitorsm-iea-energy-data", "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/aitorsm~iea-energy-data/run-sync": { "post": { "operationId": "run-sync-aitorsm-iea-energy-data", "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": { "listIndicators": { "title": "List indicators only (free)", "type": "boolean", "description": "Output one row per indicator in the live IEA catalogue (code, name, unit, IEA dataset, years available, country count, flow and product dimensions) instead of data. No row event is charged. The first run can take a minute because it computes statistics for every indicator; later runs use a 24-hour cache.", "default": false }, "indicators": { "title": "Energy indicators", "type": "array", "description": "IEA indicator codes such as SDG72modern, TotCO2, ElecGenByFuel or TESbySource, validated against the current IEA catalogue (78 codes on 2026-09-25). Enter a single item all for every indicator. Run with listIndicators to see codes, units and years.", "items": { "type": "string" }, "default": [ "SDG72modern" ] }, "countries": { "title": "Countries", "type": "array", "description": "ISO 2 or ISO 3 country codes, such as US or USA, a region code such as WORLD, or an IEA country code. Enter a single item all for every country (regional aggregates are then excluded).", "items": { "type": "string" }, "default": [ "USA" ] }, "yearStart": { "title": "First year", "minimum": 1960, "maximum": 2100, "type": "integer", "description": "Inclusive start year. Coverage starts in 1990 or 2000 depending on the indicator.", "default": 2020 }, "yearEnd": { "title": "Last year", "minimum": 1960, "maximum": 2100, "type": "integer", "description": "Inclusive end year. Leave empty for the latest year available (2022–2025 for historical series; SDG71 extends to 2050)." }, "flows": { "title": "Flow filter", "type": "array", "description": "Optional flow codes to keep, such as ESOLARPV in ElecGenByFuel or TOTTRANS in CO2BySector. Flows are the sector, fuel or series dimension of an indicator.", "items": { "type": "string" } }, "products": { "title": "Product filter", "type": "array", "description": "Optional product codes to keep, such as COAL in CO2BySource or NATGAS in TESbySource.", "items": { "type": "string" } }, "maxRows": { "title": "Maximum rows", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many rows even when more data exists.", "default": 1000 } } }, "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 } } } } } } } } } }