{ "openapi": "3.0.1", "info": { "title": "French Fuel Prices: live station prices by area", "description": "Today's fuel prices at French petrol stations (diesel, SP95, SP98, E10, E85, LPG) from the official government feed. Search around an address, by postal code, city or department; sort by cheapest fuel; one clean row per station with GPS, opening 24/7, services and shortages.", "version": "1.0", "x-build-id": "bA6Npo1EszbnPZOLW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/futurelife~french-fuel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-futurelife-french-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/futurelife~french-fuel-prices/runs": { "post": { "operationId": "runs-sync-futurelife-french-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/futurelife~french-fuel-prices/run-sync": { "post": { "operationId": "run-sync-futurelife-french-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": { "center": { "title": "Around this place", "type": "string", "description": "An address, a place or a city (e.g. \"Place du Capitole, Toulouse\", \"Gare de Lyon, Paris\"), or coordinates written \"lat, lon\" (e.g. \"43.6045, 1.4442\"). Stations within the radius below are returned, nearest first when no price sort is chosen." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Distance around the place above, in kilometres (1 to 300).", "default": 10 }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "5-digit French postal codes, e.g. 75008, 31000.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "City names (Toulouse, Lyon, \"Saint-Denis (93)\"). Every postal code of the city is included.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "French department codes: 75, 69, 13, 31, 2A, 974… Leave empty to ignore.", "items": { "type": "string" } }, "fuels": { "title": "Fuels", "type": "array", "description": "Keep only stations that sell at least one of these fuels. Leave empty for all fuels.", "items": { "type": "string", "enum": [ "gazole", "sp95", "sp98", "e10", "e85", "gplc" ], "enumTitles": [ "Diesel (Gazole)", "SP95 (unleaded 95)", "SP98 (unleaded 98)", "E10 (unleaded 95-E10)", "E85 (ethanol)", "LPG (GPLc)" ] } }, "sortByFuel": { "title": "Sort by cheapest", "enum": [ "none", "gazole", "sp95", "sp98", "e10", "e85", "gplc" ], "type": "string", "description": "Order the stations by the price of this fuel, cheapest first; stations without a price for it are left out.", "default": "none" }, "open24hOnly": { "title": "Open 24/7 only", "type": "boolean", "description": "Keep only stations with a 24-hour self-service pump.", "default": false }, "stationType": { "title": "Station type", "enum": [ "all", "road", "motorway" ], "type": "string", "description": "Road stations, motorway stations, or both.", "default": "all" }, "maxStations": { "title": "Maximum number of stations", "minimum": 1, "type": "integer", "description": "The run stops once this many stations have been exported. The whole country has about 9,800 stations.", "default": 200 }, "requestsPerSecond": { "title": "Requests per second", "minimum": 1, "maximum": 8, "type": "integer", "description": "Speed of calls to the public feed (1 to 8). The default is fine.", "default": 4 } } }, "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 } } }, "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 } } } } } } } } } }