{ "openapi": "3.0.1", "info": { "title": "French Fuel Prices Scraper: gas stations, diesel, E10, LPG", "description": "Today's fuel prices at every French petrol station (prix des carburants): diesel, SP95, SP98, E10, E85 and LPG from the official government feed. Search around an address, by postal code, city or department, cheapest first, with GPS, 24/7 pumps and services. $1 per 1,000 stations.", "version": "1.0", "x-build-id": "3NEhzycSFAcv7B9jP" }, "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 }, "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 } } } } } } } } } }