{
"openapi": "3.0.1",
"info": {
"title": "Spain Fuel Prices by City & Station — Cheapest (MINCOTUR)",
"description": "Official Spanish fuel prices for all 11,000+ stations. Search by city, province, postcode, brand, fuel or a point and radius; sort cheapest or nearest. Every fuel per station, verbatim and as numbers. Keyless, pay per station.",
"version": "0.1",
"x-build-id": "HZXFo6jvj4ynWNR5e"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nexgensignal~es-fuel-station-price-records/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nexgensignal-es-fuel-station-price-records",
"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/nexgensignal~es-fuel-station-price-records/runs": {
"post": {
"operationId": "runs-sync-nexgensignal-es-fuel-station-price-records",
"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/nexgensignal~es-fuel-station-price-records/run-sync": {
"post": {
"operationId": "run-sync-nexgensignal-es-fuel-station-price-records",
"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": {
"cities": {
"title": "Cities / towns",
"type": "array",
"description": "Municipality or locality names, e.g. Madrid, Valencia, Sevilla. Accents and case don't matter.",
"items": {
"type": "string"
}
},
"provinces": {
"title": "Provinces",
"type": "array",
"description": "Province names, e.g. Barcelona, Málaga, Asturias.",
"items": {
"type": "string"
}
},
"postcodePrefixes": {
"title": "Postcodes (start)",
"type": "array",
"description": "Postcode or its start, e.g. 28 (Madrid province), 08001.",
"items": {
"type": "string"
}
},
"latitude": {
"title": "Near latitude",
"type": "number",
"description": "With longitude and radius: only stations within the radius of this point, each with its distance."
},
"longitude": {
"title": "Near longitude",
"type": "number",
"description": "Longitude of the point."
},
"radiusKm": {
"title": "Radius (km)",
"type": "number",
"description": "Radius around the point, 0.1–500 km (default 10)."
},
"fuels": {
"title": "Fuels",
"type": "array",
"description": "Keep only stations selling at least one of these fuels. The first one sets the price used by 'Cheapest first'.",
"items": {
"type": "string",
"enum": [
"Gasolina 95 E5",
"Gasolina 95 E10",
"Gasolina 95 E5 Premium",
"Gasolina 98 E5",
"Gasolina 98 E10",
"Gasoleo A",
"Gasoleo Premium",
"Gasoleo B",
"Diésel Renovable",
"Gasolina Renovable",
"Biodiesel",
"Bioetanol",
"Gasolina 95 E25",
"Gasolina 95 E85",
"Gases licuados del petróleo",
"Gas Natural Comprimido",
"Gas Natural Licuado",
"Biogas Natural Comprimido",
"Biogas Natural Licuado",
"Hidrogeno",
"Adblue",
"Amoniaco",
"Metanol"
],
"enumTitles": [
"Gasolina 95 E5",
"Gasolina 95 E10",
"Gasolina 95 E5 Premium",
"Gasolina 98 E5",
"Gasolina 98 E10",
"Gasoleo A",
"Gasoleo Premium",
"Gasoleo B",
"Diésel Renovable",
"Gasolina Renovable",
"Biodiesel",
"Bioetanol",
"Gasolina 95 E25",
"Gasolina 95 E85",
"Gases licuados del petróleo",
"Gas Natural Comprimido",
"Gas Natural Licuado",
"Biogas Natural Comprimido",
"Biogas Natural Licuado",
"Hidrogeno",
"Adblue",
"Amoniaco",
"Metanol"
]
}
},
"brands": {
"title": "Brands",
"type": "array",
"description": "Station brands (the sign on the forecourt), e.g. REPSOL, CEPSA, BALLENOIL.",
"items": {
"type": "string"
}
},
"sortBy": {
"title": "Order",
"enum": [
"source",
"cheapest",
"nearest"
],
"type": "string",
"description": "Order of delivery. Cheapest needs a fuel; nearest needs latitude and longitude."
},
"maxRecords": {
"title": "Maximum records",
"minimum": 1,
"maximum": 400000,
"type": "integer",
"description": "Maximum records delivered and billed. You are billed only for records actually delivered. Raise it to pull the full set.",
"default": 10
}
}
},
"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
}
}
}
}
}
}
}
}
}
}