{ "openapi": "3.0.1", "info": { "title": "Fuel Prices France by Station", "description": "Current fuel prices per filling station in Italy and France, from the open data published by the two governments. Filter by city, province, postal code or distance from a point, and get one normalised row per station with every price, the cheapest one for your fuel, source, licence and dates.", "version": "0.1", "x-build-id": "PmaSjh6upNoZK5KZj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/iocodo~fuel-prices-france/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-iocodo-fuel-prices-france", "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/iocodo~fuel-prices-france/runs": { "post": { "operationId": "runs-sync-iocodo-fuel-prices-france", "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/iocodo~fuel-prices-france/run-sync": { "post": { "operationId": "run-sync-iocodo-fuel-prices-france", "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": { "fuels": { "title": "Fuels", "type": "array", "description": "Only stations that sell at least one of these fuels are returned, and only those prices are listed. Leave empty for every fuel. The first fuel you pick is the one used for the cheapest price and for sorting by price.", "items": { "type": "string", "enum": [ "diesel", "gasoline", "gasoline_e10", "gasoline_98", "e85", "lpg" ], "enumTitles": [ "Diesel (Gazole)", "Gasoline (SP95)", "Gasoline E10", "Gasoline 98 octane (SP98)", "Ethanol E85", "LPG (GPLc)" ] }, "default": [] }, "cities": { "title": "Cities", "type": "array", "description": "Optional. One city per line. The name must match the city exactly, ignoring case, accents and punctuation (Lyon, Saint-Étienne).", "items": { "type": "string" } }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "Optional. Digits only. A prefix matches every longer code, so 75 gives all of Paris and 69001 gives one arrondissement.", "items": { "type": "string" } }, "latitude": { "title": "Latitude", "type": "number", "description": "Optional. Latitude of the centre point in degrees (for example 45.764 for Lyon). Use together with longitude." }, "longitude": { "title": "Longitude", "type": "number", "description": "Optional. Longitude of the centre point in degrees (for example 4.8357 for Lyon). Use together with latitude." }, "radiusKm": { "title": "Radius around the point (km)", "minimum": 0.5, "maximum": 200, "type": "number", "description": "Only used with latitude and longitude. Stations farther than this straight-line distance are left out.", "default": 10 }, "maxStations": { "title": "Max stations", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of stations returned. The limit is applied after sorting, so with a sort order you get the best ones.", "default": 1000 }, "sortBy": { "title": "Sort by", "enum": [ "none", "price", "distance" ], "type": "string", "description": "Price sorts by the cheapest price of your first selected fuel, lowest first (needs at least one fuel). Distance sorts by the distance to your point, nearest first (needs latitude and longitude). None keeps the order of the source file.", "default": "none" } } }, "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 } } } } } } } } } }