{ "openapi": "3.0.1", "info": { "title": "European Fuel Prices: 7 Countries by Station + 29 Averages", "description": "⛽ Find the cheapest diesel and petrol in Europe in seconds. Official prices from 50,000 stations in Portugal, Spain, France, Italy, Austria, Croatia and Slovenia, plus national averages for 29 countries in euros. Search near any point, compare countries or track every price change.", "version": "0.3", "x-build-id": "1keIW8t1B8H4gJMX6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yodeling_november~eu-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yodeling_november-eu-fuel-prices", "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/yodeling_november~eu-fuel-prices/runs": { "post": { "operationId": "runs-sync-yodeling_november-eu-fuel-prices", "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/yodeling_november~eu-fuel-prices/run-sync": { "post": { "operationId": "run-sync-yodeling_november-eu-fuel-prices", "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": { "countries": { "title": "Countries", "type": "array", "description": "Station-level prices from official sources. Austria: E-Control (only the cheapest stations in each state, by design). Croatia and Slovenia: the ministries of economy. Spain: Ministry for the Ecological Transition. France: DGCCRF. Italy: MIMIT (prices in force at 08:00 the previous day). Portugal: DGEG (mainland). For national averages in any EU country, the UK or Norway, use Country averages below. Leave empty to get only averages.", "items": { "type": "string", "enum": [ "AT", "ES", "FR", "HR", "IT", "PT", "SI" ], "enumTitles": [ "Austria", "Spain", "France", "Croatia", "Italy", "Portugal", "Slovenia" ] }, "default": [ "ES" ] }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Harmonized fuel types across countries. The original local fuel name is kept in the output (fuelName).", "items": { "type": "string", "enum": [ "diesel", "diesel_premium", "hvo", "gasoline_95", "gasoline_95_e10", "gasoline_95_premium", "gasoline_98", "lpg", "cng", "lng", "e85", "adblue", "other" ], "enumTitles": [ "Diesel (B7)", "Premium diesel", "Renewable diesel (HVO)", "Gasoline 95 (E5)", "Gasoline 95 E10", "Premium gasoline 95", "Gasoline 98 / 100", "LPG (Autogas)", "CNG", "LNG", "E85 / bioethanol", "AdBlue", "Other" ] }, "default": [ "diesel", "gasoline_95" ] }, "region": { "title": "Region", "type": "string", "description": "Optional. Province (ES, e.g. Madrid), département (FR, e.g. Gironde), province code (IT, e.g. RM), state (AT, e.g. Wien) or county (HR, e.g. Splitsko-dalmatinska). Slovenia has no region field: use Postal code prefix. Case and accents are ignored." }, "municipality": { "title": "Municipality", "type": "string", "description": "Optional. Municipality / municipio / commune / comune / Gemeinde / grad or općina. Case and accents are ignored." }, "postalCodePrefix": { "title": "Postal code prefix", "type": "string", "description": "Optional. Keep only stations whose postal code starts with this text, e.g. 28 (ES), 75 (FR), 1010 (AT), 1000 (SI). Croatia's data has no postal codes." }, "brands": { "title": "Brands", "type": "array", "description": "Optional. Keep only these brands (partial match, case-insensitive), e.g. Repsol, BP, Eni, INA, Petrol, OMV. France's open data has no brand field, so this filter removes all French stations. In Croatia and Slovenia the brand is the operating company.", "items": { "type": "string" } }, "nearLocation": { "title": "Near location (latitude, longitude)", "type": "string", "description": "Optional. Decimal coordinates, e.g. 40.4168, -3.7038. Adds distanceKm to each result and keeps stations within the radius below." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Used with Near location.", "default": 10 }, "sortBy": { "title": "Sort by", "enum": [ "price", "distance", "none" ], "type": "string", "description": "Price sorts cheapest first. Distance requires Near location.", "default": "price" }, "maxResultsPerFuel": { "title": "Max results per fuel type", "minimum": 0, "type": "integer", "description": "Cap per fuel type after sorting, so 'price' + 10 gives the 10 cheapest stations for each fuel. 0 means no cap. Country averages are never capped.", "default": 20 }, "maxPriceAgeDays": { "title": "Ignore prices older than (days)", "minimum": 0, "type": "integer", "description": "Drops prices that stations have not updated for this many days. 0 keeps everything.", "default": 30 }, "excludeOutliers": { "title": "Exclude implausible prices", "type": "boolean", "description": "Drops obvious data-entry errors reported by stations (for example 1.000 or 8.888 EUR/l): prices below 75% (90% for petrol 95 and diesel in Croatia and Slovenia) or above 150% of the national median for the same fuel. AdBlue and 'other' are not checked.", "default": true }, "averageCountries": { "title": "Country averages", "type": "array", "description": "Optional. National average pump prices: the 27 EU countries plus the EU and euro-area averages (European Commission Weekly Oil Bulletin, weekly), the United Kingdom (DESNZ, weekly) and Norway (Statistics Norway, monthly). Petrol 95 and diesel everywhere, LPG for most EU countries. price is in the local currency, priceEur converts it with the ECB reference rate. Station filters do not apply.", "items": { "type": "string", "enum": [ "AT", "BE", "BG", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL", "NO", "PL", "PT", "RO", "SK", "SI", "ES", "SE", "GB", "EU", "EA" ], "enumTitles": [ "Austria", "Belgium", "Bulgaria", "Croatia", "Cyprus", "Czechia", "Denmark", "Estonia", "Finland", "France", "Germany", "Greece", "Hungary", "Ireland", "Italy", "Latvia", "Lithuania", "Luxembourg", "Malta", "Netherlands", "Norway", "Poland", "Portugal", "Romania", "Slovakia", "Slovenia", "Spain", "Sweden", "United Kingdom", "EU-27 (weighted average)", "Euro area (weighted average)" ] } }, "mode": { "title": "Mode", "enum": [ "snapshot", "changes" ], "type": "string", "description": "Snapshot returns current prices. Changes returns only prices that are new or changed since the previous run with the same Monitor ID, with the previous price, which suits scheduled runs. Country averages are included in the changes.", "default": "snapshot" }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name for the saved state in Changes mode. Use a different ID for each monitored area or filter set.", "default": "default" } } }, "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 } } } } } } } } } }