{ "openapi": "3.0.1", "info": { "title": "Fuel Prices Scraper France & Spain - Gas Stations", "description": "Cheapest fuel near you: official open data of all gas stations in France and Spain with diesel, E10, 95, 98, LPG and E85 prices, address, coordinates and update time. Filter by radius, city or postcode. No login. Pay per station.", "version": "0.1", "x-build-id": "KeiQE5AwWNyVR6dhG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thequietstack~fuel-prices-france-spain/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thequietstack-fuel-prices-france-spain", "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/thequietstack~fuel-prices-france-spain/runs": { "post": { "operationId": "runs-sync-thequietstack-fuel-prices-france-spain", "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/thequietstack~fuel-prices-france-spain/run-sync": { "post": { "operationId": "run-sync-thequietstack-fuel-prices-france-spain", "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 files to read.", "items": { "type": "string", "enum": [ "FR", "ES" ], "enumTitles": [ "France", "Spain" ] }, "default": [ "FR", "ES" ] }, "fuelTypes": { "title": "Fuel types (station must sell all)", "type": "array", "description": "Only stations that sell every selected fuel are returned. Empty = any station.", "items": { "type": "string", "enum": [ "diesel", "diesel_premium", "petrol95", "petrol95_e10", "petrol98", "e85", "lpg" ], "enumTitles": [ "Diesel", "Premium diesel (ES)", "Petrol 95 (E5)", "Petrol 95 E10", "Petrol 98", "E85 bioethanol", "LPG" ] }, "default": [ "diesel" ] }, "sortByFuel": { "title": "Sort by price of", "enum": [ "diesel", "diesel_premium", "petrol95", "petrol95_e10", "petrol98", "e85", "lpg" ], "type": "string", "description": "Cheapest first, for this fuel.", "default": "diesel" }, "sortBy": { "title": "Sort order", "enum": [ "price", "distance" ], "type": "string", "description": "Order of the result.", "default": "price" }, "latitude": { "title": "Center latitude", "type": "number", "description": "Optional center point, e.g. 48.8566 (Paris)." }, "longitude": { "title": "Center longitude", "type": "number", "description": "Optional center point, e.g. 2.3522 (Paris)." }, "radiusKm": { "title": "Radius (km)", "type": "number", "description": "With center point: only stations within this distance." }, "postalCodes": { "title": "Postal code prefixes", "type": "array", "description": "e.g. 75 (Paris), 28 (Madrid), 08 (Barcelona), 13001.", "items": { "type": "string" } }, "city": { "title": "City or province contains", "type": "string", "description": "Case and accent insensitive, e.g. Lyon, Sevilla." }, "maxPrice": { "title": "Max price per litre (EUR)", "type": "number", "description": "Applies to the sorting fuel." }, "includeMembersOnly": { "title": "Include members-only stations (ES)", "type": "boolean", "description": "Some Spanish stations (e.g. cooperatives) sell to members only. They are skipped by default.", "default": false }, "maxStations": { "title": "Max stations", "minimum": 1, "type": "integer", "description": "Result size after sorting.", "default": 100 } } }, "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 } } } } } } } } } }