{ "openapi": "3.0.1", "info": { "title": "German Electricity Prices & Generation Mix (SMARD)", "description": "Day-ahead electricity prices, generation by source, grid load and forecasts for Germany and its neighbours from the official Bundesnetzagentur SMARD data (CC BY 4.0). Today, tomorrow or any period back to 2015, in 15-minute to yearly steps.", "version": "1.0", "x-build-id": "E1Bp91tLxozeRKh7V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/opendata-souce2026~german-electricity-prices-smard/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-opendata-souce2026-german-electricity-prices-smard", "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/opendata-souce2026~german-electricity-prices-smard/runs": { "post": { "operationId": "runs-sync-opendata-souce2026-german-electricity-prices-smard", "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/opendata-souce2026~german-electricity-prices-smard/run-sync": { "post": { "operationId": "run-sync-opendata-souce2026-german-electricity-prices-smard", "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": { "preset": { "title": "What do you need?", "enum": [ "prices", "marketOverview", "generationMix", "neighbourPrices" ], "type": "string", "description": "Quick choice of data series. Ignored if you pick individual series below.", "default": "marketOverview" }, "series": { "title": "Individual series (optional)", "type": "array", "description": "Pick exact series instead of a preset.", "items": { "type": "string", "enum": [ "priceDeLu", "priceDeLuNeighbours", "priceAustria", "priceBelgium", "priceNorway2", "priceDenmark1", "priceDenmark2", "priceFrance", "priceItalyNorth", "priceNetherlands", "pricePoland", "priceSwitzerland", "priceSlovenia", "priceCzechia", "priceHungary", "genLignite", "genNuclear", "genWindOffshore", "genHydro", "genOtherConventional", "genOtherRenewable", "genBiomass", "genWindOnshore", "genSolar", "genHardCoal", "genPumpedStorage", "genNaturalGas", "consumptionTotal", "residualLoad", "consumptionPumpedStorage", "forecastWindOffshore", "forecastWindOnshore", "forecastOther", "forecastWindAndSolar", "forecastTotal" ], "enumTitles": [ "Price Germany/Luxembourg", "Price: average of DE/LU neighbours", "Price Austria", "Price Belgium", "Price Norway 2", "Price Denmark 1", "Price Denmark 2", "Price France", "Price Italy (North)", "Price Netherlands", "Price Poland", "Price Switzerland", "Price Slovenia", "Price Czechia", "Price Hungary", "Generation: lignite", "Generation: nuclear", "Generation: wind offshore", "Generation: hydro", "Generation: other conventional", "Generation: other renewable", "Generation: biomass", "Generation: wind onshore", "Generation: solar", "Generation: hard coal", "Generation: pumped storage", "Generation: natural gas", "Consumption: total (grid load)", "Consumption: residual load", "Consumption: pumped storage", "Forecast: wind offshore", "Forecast: wind onshore", "Forecast: other", "Forecast: wind and solar", "Forecast: total generation" ] } }, "period": { "title": "Time period", "enum": [ "today", "tomorrow", "todayAndTomorrow", "last24Hours", "last7Days", "last30Days", "lastYear", "custom" ], "type": "string", "description": "Days follow German local time. Day-ahead prices for tomorrow are usually published around 13:00.", "default": "last7Days" }, "startDate": { "title": "Start date (custom period)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Format YYYY-MM-DD. Data goes back to 2015 for most series." }, "endDate": { "title": "End date (custom period, inclusive)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Format YYYY-MM-DD. Defaults to today." }, "resolution": { "title": "Resolution", "enum": [ "quarterhour", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Size of each time step. Day-ahead prices have been traded in 15-minute steps since October 2025.", "default": "hour" }, "region": { "title": "Region / grid area", "enum": [ "DE", "DE-LU", "DE-AT-LU", "AT", "LU", "50Hertz", "Amprion", "TenneT", "TransnetBW", "APG", "Creos" ], "type": "string", "description": "Generation and consumption are available per country and per German transmission grid operator.", "default": "DE" }, "outputFormat": { "title": "Output format", "enum": [ "wide", "long" ], "type": "string", "description": "Wide: one row per time step with a column per series. Long: one row per time step and series.", "default": "wide" }, "maxRows": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Safety limit for very long 15-minute queries.", "default": 100000 } } }, "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 } } } } } } } } } }