{ "openapi": "3.0.1", "info": { "title": "European Fuel Prices by Station (France, Italy)", "description": "Current petrol, diesel and LPG prices per filling station in France and Italy from official open data feeds, one schema, filter by fuel, region, city and cheapest N.", "version": "0.1", "x-build-id": "YR8ehh3JvzoRCFRwB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aesthetic_gewgaw~europe-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aesthetic_gewgaw-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/aesthetic_gewgaw~europe-fuel-prices/runs": { "post": { "operationId": "runs-sync-aesthetic_gewgaw-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/aesthetic_gewgaw~europe-fuel-prices/run-sync": { "post": { "operationId": "run-sync-aesthetic_gewgaw-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 national price feeds to read. France comes from the government fuel price open data feed (updated about every 10 minutes) and Italy from the Ministry of Enterprise daily price file.", "items": { "type": "string", "enum": [ "FR", "IT" ] }, "default": [ "FR", "IT" ] }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Keep only these fuels. diesel, petrol95 (95 octane E5), petrol95_e10, petrol98, e85, lpg, cng, lng, hvo, diesel_premium, petrol_premium. Leave empty for all.", "items": { "type": "string" } }, "region": { "title": "Region, department or province contains", "type": "string", "description": "Text matched against the region and the department (France) or province code and region (Italy), for example Bretagne, Rhone or MI." }, "city": { "title": "City contains", "type": "string", "description": "Only stations whose city name contains this text, for example Lyon or Torino." }, "postalCodePrefix": { "title": "Postal code starts with", "type": "string", "description": "For example 75 for Paris. Italian stations have no postal code in the feed, so use region or city there." }, "selfServiceOnly": { "title": "Self-service prices only (Italy)", "type": "boolean", "description": "Italy publishes separate self-service and served prices. Turn on to keep only self-service. France has one price per fuel.", "default": false }, "maxAgeDays": { "title": "Maximum price age (days)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Drop prices the station has not updated within this many days, so stale prices do not look cheap. Use 0 to keep all.", "default": 7 }, "maxPriceEur": { "title": "Maximum price (EUR per litre or kg)", "type": "number", "description": "Drop prices above this value." }, "cheapestPerFuel": { "title": "Cheapest N per country and fuel", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Keep only the N cheapest stations for each country and fuel after the other filters. Leave empty to keep all." }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many records. You are charged per result, so this is also your spending cap.", "default": 200 } } }, "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 } } } } } } } } } }