{ "openapi": "3.0.1", "info": { "title": "German Fuel Station Prices Scraper - Petrol & Diesel", "description": "$0.5/1K 🔥 German fuel price scraper! Live petrol & diesel prices for 15k stations with brands & locations. JSON, CSV, Excel or API in seconds. Build price comparison & fleet tools ⚡", "version": "0.1", "x-build-id": "impVpROoYzChsFcGW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ninhothedev~fuel-prices-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ninhothedev-fuel-prices-scraper", "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/ninhothedev~fuel-prices-scraper/runs": { "post": { "operationId": "runs-sync-ninhothedev-fuel-prices-scraper", "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/ninhothedev~fuel-prices-scraper/run-sync": { "post": { "operationId": "run-sync-ninhothedev-fuel-prices-scraper", "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": "Scrape mode", "enum": [ "radius", "stations" ], "type": "string", "description": "How to find stations. 'radius' searches around one or more lat,lng centre points and returns current prices. 'stations' takes explicit station UUIDs and returns the full detail record including opening hours.", "default": "radius" }, "centers": { "title": "Centre points (lat,lng)", "type": "array", "description": "Centre points for the radius search, each as a 'lat,lng' string (for example '52.5200,13.4050' for Berlin). Add as many as you like - every centre is searched separately and results are de-duplicated by station ID. Used in 'radius' mode only.", "default": [ "52.5200,13.4050", "48.1351,11.5820" ], "items": { "type": "string" } }, "radiusKm": { "title": "Search radius (km)", "minimum": 1, "maximum": 25, "type": "integer", "description": "Search radius around each centre point in kilometres. The Tankerkoenig API silently caps this at 25 km, so larger values are clamped. Used in 'radius' mode only.", "default": 5 }, "fuelType": { "title": "Fuel type", "enum": [ "all", "e5", "e10", "diesel" ], "type": "string", "description": "Which fuel to query. 'all' returns diesel, E5 and E10 prices for every station. Choosing a single fuel returns only that price but sorts the results by price (cheapest first).", "default": "all" }, "stationIds": { "title": "Station IDs", "type": "array", "description": "Tankerkoenig station UUIDs to look up, for example '278130b1-e062-4a0f-80cc-19e486b4c024'. Run 'radius' mode first to discover the IDs you need. Used in 'stations' mode only.", "default": [], "items": { "type": "string" } }, "apiKey": { "title": "Tankerkoenig API key", "type": "string", "description": "Your personal Tankerkoenig API key. The default is the shared public DEMO key: it returns real station master data but PLACEHOLDER prices (1.009 / 1.234 EUR). Request a free personal key at creativecommons.tankerkoenig.de to receive live prices.", "default": "00000000-0000-0000-0000-000000000002" }, "maxItems": { "title": "Maximum stations", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many stations have been collected across all centre points or station IDs. Keeps runs predictable and cheap.", "default": 500 } } }, "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 } } } } } } } } } }