{ "openapi": "3.0.1", "info": { "title": "Argentina Fuel Prices API by Station (Official)", "description": "Get fuel prices Argentine stations report to the Secretaria de Energia: nafta super, gas oil and GNC in ARS per station, with brand, address, coordinates and per-fuel dates. For fleets, station owners and AI agents: cheapest nearby, area averages, no API key. JSON, CSV, API or MCP; $3/1,000 rows.", "version": "0.1", "x-build-id": "VdopBXDYS8dpEelN6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/japan-open-data~argentina-fuel-station-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-japan-open-data-argentina-fuel-station-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/japan-open-data~argentina-fuel-station-prices/runs": { "post": { "operationId": "runs-sync-japan-open-data-argentina-fuel-station-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/japan-open-data~argentina-fuel-station-prices/run-sync": { "post": { "operationId": "run-sync-japan-open-data-argentina-fuel-station-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", "required": [ "latitude", "longitude" ], "properties": { "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude of the search center in decimal degrees; Argentine latitudes are negative (about -56 to -21). Default: Buenos Aires (Obelisco), -34.6037.", "default": -34.6037 }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude of the search center in decimal degrees; Argentine longitudes are negative (about -74 to -53). Default: Buenos Aires (Obelisco), -58.3816.", "default": -58.3816 }, "radiusKm": { "title": "Search radius (km)", "minimum": 0.1, "maximum": 4000, "type": "number", "description": "Only stations within this distance of the point are returned (0.1 to 4000 km; 4000 covers all of Argentina). Ignored when you fill in \"province\" or \"city\".", "default": 10 }, "province": { "title": "Province (optional)", "type": "string", "description": "Return the stations of this province instead of a radius search, e.g. \"BUENOS AIRES\", \"CAPITAL FEDERAL\", \"CORDOBA\", \"SANTA FE\", \"MENDOZA\". Accents and upper/lower case are ignored and a partial name matches. Leave empty to search by radius.", "default": "" }, "city": { "title": "City / locality (optional)", "type": "string", "description": "Return the stations of this locality (localidad) instead of a radius search, e.g. \"ROSARIO\", \"MAR DEL PLATA\", \"SAN MIGUEL DE TUCUMAN\". Accents and upper/lower case are ignored and a partial name matches. Can be combined with \"province\".", "default": "" }, "fuelType": { "title": "Fuel type", "enum": [ "any", "super", "premium", "diesel", "dieselPremium", "cng" ], "type": "string", "description": "\"any\" returns every station with at least one price inside the age limit; a specific fuel returns only the stations that report it, and price sorting uses it (super when \"any\").", "default": "any" }, "maxPriceAgeDays": { "title": "Maximum price age (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "The file holds the LAST price each station reported, not today's price, so only prices whose effective date (fecha de vigencia) is within this many days are returned. With 90 about 890 of the 4,600 stations come back; with 30 about 300, with 7 about 70. Lower it when you need accuracy, raise it (up to 3650) for the last known price of every station. The age limit is applied to each fuel separately, and every row carries the report date and age in days of each fuel (superPriceAgeDays ... cngPriceAgeDays) plus priceAgeDays for the oldest price in the row.", "default": 90 }, "timeOfDay": { "title": "Day or night price", "enum": [ "day", "night" ], "type": "string", "description": "Argentine stations report a daytime (diurno) and a night-time (nocturno) price. They are identical at about 99.5% of stations; \"day\" is the usual choice. The output field nightPriceDiffers tells you when the other shift is different.", "default": "day" }, "sortBy": { "title": "Sort by", "enum": [ "distance", "price" ], "type": "string", "description": "\"distance\" = nearest first; \"price\" = cheapest first for the selected fuel (super when fuel type is \"any\"; stations without that price go last). Prices were reported on different dates, so an old report can look cheap: check that fuel's age field (e.g. dieselPriceAgeDays) in the rows at the top, or lower maxPriceAgeDays.", "default": "distance" }, "maxResults": { "title": "Maximum stations", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum number of station rows to return (1 to 20000).", "default": 50 }, "includeSummary": { "title": "Add a price summary row", "type": "boolean", "description": "Adds one extra row (rowType \"summary\") with the number of stations and the minimum, maximum and average price of each fuel in the area (all matching stations, not only the returned ones).", "default": false } } }, "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 } } } } } } } } } }