{ "openapi": "3.0.1", "info": { "title": "Europe Fuel Prices: Diesel & Petrol by Station (FR, ES, AT, UK)", "description": "Diesel, petrol (E5, E10, 98), LPG and E85 prices for every fuel station in France and Spain, plus Austria's cheapest stations and UK retailer feeds, from official open data. Radius search, sort by price, GPS, brand. $0.50 per 1,000 stations.", "version": "0.1", "x-build-id": "DhQDIXHjncAgzKog1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/larkmoor~europe-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-larkmoor-europe-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/larkmoor~europe-fuel-prices/runs": { "post": { "operationId": "runs-sync-larkmoor-europe-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/larkmoor~europe-fuel-prices/run-sync": { "post": { "operationId": "run-sync-larkmoor-europe-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": "Which countries to read. FR = all ~9,800 French stations, ES = all ~11,400 Spanish stations, AT = the cheapest stations of every Austrian district (that is what E-Control publishes), UK = the retailers' open price feeds (Asda, Esso, Moto, SGN, JET and more).", "items": { "type": "string", "enum": [ "FR", "ES", "AT", "UK" ], "enumTitles": [ "France", "Spain", "Austria", "United Kingdom" ] }, "default": [ "FR" ] }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Keep only stations that sell at least one of these fuels (and use the first one for sorting by price). Leave empty for all fuels.", "items": { "type": "string", "enum": [ "diesel", "premiumDiesel", "e10", "e5", "superPlus", "lpg", "e85", "cng" ], "enumTitles": [ "Diesel (B7 / Gazole / Gasóleo A)", "Premium diesel", "Petrol E10", "Petrol E5 / SP95 / Super 95", "Super plus 98 / UK super unleaded", "LPG (GPL)", "E85 bioethanol", "CNG" ] }, "default": [] }, "latitude": { "title": "Near latitude", "type": "string", "description": "Optional centre point for a radius search, e.g. 48.8566 (Paris). Use together with longitude and radius." }, "longitude": { "title": "Near longitude", "type": "string", "description": "Optional centre point longitude, e.g. 2.3522." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Radius around the centre point.", "default": 10 }, "cities": { "title": "Cities", "type": "array", "description": "Optional: keep only stations whose city or address contains one of these words (e.g. Lyon, Madrid, Leeds).", "items": { "type": "string" } }, "postalCodePrefixes": { "title": "Postal code prefixes", "type": "array", "description": "Optional: keep only stations whose postal code starts with one of these (e.g. 75 for Paris, 28 for Madrid province, SW1 for London).", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Optional: keep only these brands (matched in brand or station name, e.g. Repsol, Asda, OMV). France's feed carries no brand names.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "none", "price", "distance" ], "type": "string", "description": "Order of the results. Price uses the first fuel in Fuel types (diesel if none).", "default": "none" }, "maxPriceAgeDays": { "title": "Max price age (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Leave out stations whose prices were last updated more than this many days ago (some UK retailer feeds are stale). 0 = keep all.", "default": 14 }, "maxResults": { "title": "Max stations", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many stations.", "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 } } } } } } } } } }