{ "openapi": "3.0.1", "info": { "title": "European Fuel Prices Scraper - Italy, Spain, France", "description": "Petrol, diesel, LPG, CNG and HVO prices for 42,000+ filling stations in Italy, Spain and France, straight from the three governments' official open data. One comparable fuel taxonomy, explicit units and radius search. You pay only for the price records you receive.", "version": "0.1", "x-build-id": "avHvUeDXEWImy3YV8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/koukkis~european-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-koukkis-european-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/koukkis~european-fuel-prices/runs": { "post": { "operationId": "runs-sync-koukkis-european-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/koukkis~european-fuel-prices/run-sync": { "post": { "operationId": "run-sync-koukkis-european-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 national open-data feeds to query. Leave empty for all three.", "items": { "type": "string", "enum": [ "IT", "ES", "FR" ], "enumTitles": [ "Italy", "Spain", "France" ] }, "default": [ "IT", "ES", "FR" ] }, "fuels": { "title": "Fuel types", "type": "array", "description": "Normalised fuel categories. Leave empty to return every fuel. National brand names such as Blue Diesel, Hi-Q Diesel or Gasoleo Premium are mapped onto these automatically.", "items": { "type": "string", "enum": [ "diesel", "diesel_premium", "diesel_arctic", "diesel_agricultural", "hvo", "petrol_95", "petrol_98", "petrol_100", "petrol_premium", "e10", "e85", "lpg", "cng", "lng", "hydrogen", "biodiesel", "methanol", "adblue" ], "enumTitles": [ "Diesel", "Diesel (premium)", "Diesel (arctic)", "Diesel (agricultural)", "HVO / renewable diesel", "Petrol 95", "Petrol 98", "Petrol 100+", "Petrol (premium, branded)", "E10", "E85", "LPG", "CNG", "LNG", "Hydrogen", "Biodiesel", "Methanol", "AdBlue" ] }, "default": [] }, "latitude": { "title": "Latitude", "type": "string", "description": "Optional centre point for a radius search, in decimal degrees, e.g. 40.4168. Give it together with longitude; a run with only one of them, or with a value that is not a number, fails before anything is fetched or charged." }, "longitude": { "title": "Longitude", "type": "string", "description": "Decimal degrees, e.g. -3.7038. Used together with latitude." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Search radius around the given point.", "default": 25 }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "The most price records to deliver, and pay for. When several countries are selected the limit is shared between them, so the default run shows all three. Set to 0 for no limit: about 167,000 records for all three countries. Your maximum cost per run caps this too.", "default": 1000 }, "includeSuspectPrices": { "title": "Include implausible prices", "type": "boolean", "description": "National feeds contain occasional data-entry errors, for example diesel listed at 8.888 EUR/l. They are always flagged with price_suspect rather than silently deleted, and excluded unless you turn this on.", "default": false }, "selfServiceOnly": { "title": "Self-service prices only (Italy)", "type": "boolean", "description": "Italy publishes both self-service and served prices for the same pump. Spain and France do not distinguish them and are unaffected.", "default": false } } }, "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 } } } } } } } } } }