{ "openapi": "3.0.1", "info": { "title": "Official Fuel Prices — France, Spain, Italy & Western Australia", "description": "Live fuel prices from official government open data (France, Spain, Italy, Western Australia) in one normalized schema. Search by radius, postal code, city, brand and fuel type; sort by price or distance. No API key.", "version": "0.1", "x-build-id": "e7rwefd2ys0I3Nhgz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sste~official-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sste-official-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/sste~official-fuel-prices/runs": { "post": { "operationId": "runs-sync-sste-official-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/sste~official-fuel-prices/run-sync": { "post": { "operationId": "run-sync-sste-official-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 / regions", "type": "array", "description": "Official sources to query. Leave empty to auto-select from the location below, or to query all sources when no location is given.", "items": { "type": "string", "enum": [ "FR", "ES", "IT", "AU-WA" ], "enumTitles": [ "France", "Spain", "Italy", "Australia — Western Australia" ] } }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Normalized fuel types. Leave empty for all fuels. The original label from the official feed is always kept in `fuelName`.", "items": { "type": "string", "enum": [ "gasoline_91", "gasoline_95", "gasoline_95_e10", "gasoline_98", "gasoline_98_e10", "gasoline_premium", "e85", "diesel", "diesel_premium", "hvo", "lpg", "cng", "lng", "hydrogen", "other" ], "enumTitles": [ "Gasoline 91 (AU ULP)", "Gasoline 95", "Gasoline 95 E10", "Gasoline 98", "Gasoline 98 E10", "Premium gasoline (branded)", "E85", "Diesel", "Premium diesel (branded)", "HVO / renewable diesel", "LPG", "CNG (per kg)", "LNG (per kg)", "Hydrogen (per kg)", "Other" ] } }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Search around a point (WGS84 decimal degrees). Use together with longitude and radius." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "WGS84 decimal degrees." }, "radiusKm": { "title": "Radius (km)", "minimum": 0.1, "maximum": 500, "type": "number", "description": "Maximum straight-line distance from the point. Each result gets a `distanceKm` field.", "default": 10 }, "postalCodes": { "title": "Postal codes (prefix match)", "type": "array", "description": "Keep stations whose postal code starts with one of these values, e.g. \"75\" for Paris or \"28001\". Not available for Italy and Western Australia (the official feeds have no postal code).", "items": { "type": "string" } }, "cities": { "title": "Cities / suburbs", "type": "array", "description": "Exact city or suburb name, case- and accent-insensitive (e.g. \"Málaga\", \"MILANO\", \"Perth\").", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Keep stations whose brand contains one of these words (e.g. \"repsol\", \"eni\", \"ampol\"). Brand is not published by the French feed.", "items": { "type": "string" } }, "maxPriceAgeHours": { "title": "Maximum price age (hours)", "minimum": 1, "type": "integer", "description": "Drop prices last updated more than this many hours ago. Useful for France, where some stations report infrequently." }, "excludeRestricted": { "title": "Exclude restricted-access stations", "type": "boolean", "description": "Spain flags stations that only sell to members (cooperatives, fleets). Enable to drop them.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "price", "distance", "none" ], "type": "string", "description": "\"price\" sorts cheapest first within each fuel type and currency; \"distance\" needs a location.", "default": "price" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Upper bound on output rows (one row = one fuel price at one station). You are charged per row.", "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 } } } } } } } } } }