{ "openapi": "3.0.1", "info": { "title": "Europe Official Fuel Prices (FR, ES)", "description": "Official pump prices from the French and Spanish government open-data feeds: one row per station and fuel, with brand, address, coordinates, price and update time.", "version": "0.1", "x-build-id": "4gTWzaT8bsI3LSFrT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/homelabmobile~eu-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-homelabmobile-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/homelabmobile~eu-fuel-prices/runs": { "post": { "operationId": "runs-sync-homelabmobile-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/homelabmobile~eu-fuel-prices/run-sync": { "post": { "operationId": "run-sync-homelabmobile-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", "uniqueItems": true, "type": "array", "description": "ISO country codes to include, in this order: \"FR\" (France, about 9,800 stations, updated every 10 minutes), \"ES\" (Spain, about 11,500 stations, updated every 30 minutes). Leave empty for both. Italy is temporarily unavailable because its official server is unreachable. Rows come out country by country, so put the country you care most about first when maxResults is small.", "items": { "type": "string", "enum": [ "FR", "ES" ], "enumTitles": [ "France", "Spain" ] }, "default": [ "FR", "ES" ] }, "fuelTypes": { "title": "Fuel types", "uniqueItems": true, "type": "array", "description": "Optional. Only return these normalised fuel types. petrol_95 = unleaded 95 (E5, French SP95), petrol_95_e10 = E10, petrol_98 = unleaded 98, petrol_premium = branded premium petrol, e85 = bioethanol E85, diesel = standard diesel (French Gazole, Spanish Gasoleo A), diesel_premium = branded premium diesel, diesel_agricultural = Spanish Gasoleo B, hvo = HVO/renewable diesel, lpg = LPG/autogas, cng = compressed natural gas/methane, lng = liquefied natural gas, hydrogen, adblue, other = anything else. Leave empty for all fuels.", "items": { "type": "string", "enum": [ "petrol_95", "petrol_95_e10", "petrol_98", "petrol_premium", "e85", "diesel", "diesel_premium", "diesel_agricultural", "hvo", "lpg", "cng", "lng", "hydrogen", "adblue", "other" ] } }, "municipality": { "title": "Municipality", "type": "string", "description": "Optional. Only stations in this municipality (town or city), matched on the whole name, ignoring case and accents, e.g. \"Lyon\", \"Madrid\". For Spain the station's 'Localidad' is also matched." }, "province": { "title": "Province / departement", "type": "string", "description": "Optional. Only stations in this province. France: departement number, e.g. \"75\", \"69\", \"2A\". Spain: province name or two-digit INE code, e.g. \"Madrid\" or \"28\". Case and accents are ignored." }, "postcodePrefix": { "title": "Postcode prefix", "type": "string", "description": "Optional. Only stations whose postcode starts with this, e.g. \"750\" for central Paris or \"28\" for Madrid province." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Stop after this many rows (one row = one station and fuel type). You are charged per row, so this caps the cost of a run. A full snapshot of both countries is about 77,000 rows.", "default": 100 } } }, "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 } } } } } } } } } }