Las gasolineras más baratas

GET

/v1/stations/cheapest

const url = 'https://api.preciosgasolina.es/v1/stations/cheapest?fuel=gasoline_95&level=spain&limit=10';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.preciosgasolina.es/v1/stations/cheapest?fuel=gasoline_95&level=spain&limit=10'

Las más baratas de España, de un territorio (level + code) o alrededor de un punto (lat + lng + radius_km). En el ranking de España, Canarias, Ceuta y Melilla van aparte salvo include_low_tax=true.

Herramienta MCP equivalente: find_cheapest_fuel.

Límite: 120 peticiones/min por IP. Caché: hasta la próxima actualización de los datos (≈ 8:00 y 20:00, hora peninsular).

Parámetros

Parámetros de consulta

fuel

string

por defecto: gasoline_95

Valores permitidos: gasoline_95 gasoline_98 diesel diesel_premium lpg cng

Carburante: gasoline_95, gasoline_98, diesel, diesel_premium, lpg, cng.

level

string

Valores permitidos: spain community province municipality

Nivel territorial. community y province usan el código INE (p. ej. 13, 28); municipality, el id de municipio de /v1/territories o /v1/search.

code

string

>= 1 caracteres <= 60 caracteres /^[a-z0-9-]+$/

Código del territorio (INE para comunidad y provincia, id para municipio) o su slug.

lat

number

>= 27.4 <= 44

Latitud WGS84 (España, Canarias incluidas).

lng

number

>= -18.4 <= 4.6

Longitud WGS84.

radius_km

number

> 0 <= 50

Radio en km (máximo 50).

limit

integer

por defecto: 10 >= 1 <= 50

Número de resultados (1–50).

open_24h

Cualquiera de:

boolean
string

boolean

brand

string

>= 1 caracteres <= 120 caracteres /^[a-z0-9-]+$/

include_low_tax

Cualquiera de:

boolean
string

boolean

Respuestas

200

Correcto: sobre { data, meta }.

application/json

object

data

obligatorio

object

fuel

obligatorio

Carburante: gasoline_95, gasoline_98, diesel, diesel_premium, lpg, cng.

string

Valores permitidos: gasoline_95 gasoline_98 diesel diesel_premium lpg cng

unit

obligatorio

string

Valores permitidos: L kg

currency

obligatorio

string

Valor permitido: EUR

area

object

level

obligatorio

string

Valores permitidos: spain community province municipality

code

obligatorio

string

name

obligatorio

string

web_url

obligatorio

string formato: uri

note

obligatorio

string | null

stations

obligatorio

Array<object>

object

obligatorio

Identificador del Ministerio (IDEESS).

integer

>= -9007199254740991 <= 9007199254740991

name

obligatorio

string | null

brand

obligatorio

Cualquiera de:

object
null

object

slug

obligatorio

string

name

obligatorio

string | null

address

obligatorio

string | null

postal_code

obligatorio

string | null

municipality

obligatorio

object

obligatorio

Cualquiera de:

integer
null

integer

>= -9007199254740991 <= 9007199254740991

name

obligatorio

string | null

province

obligatorio

object

code

obligatorio

string

name

obligatorio

string | null

community

obligatorio

object

code

obligatorio

string

name

obligatorio

string | null

lat

obligatorio

number

lng

obligatorio

number

is_24h

obligatorio

boolean

hours

obligatorio

string | null

low_tax_area

obligatorio

Canarias, Ceuta o Melilla (sin Impuesto sobre Hidrocarburos).

boolean

price

Precio del carburante pedido (€/L; €/kg con GNC).

number | null

price_updated_at

string | null

distance_km

number | null

distance_to_route_km

number | null

position_km

number | null

web_url

obligatorio

Ficha de la gasolinera en preciosgasolina.es.

string formato: uri

meta

obligatorio

object

api_version

obligatorio

string

request_id

obligatorio

string

last_updated

obligatorio

Fecha y hora de los datos (ISO 8601).

string | null

next_update

obligatorio

Próxima actualización prevista (≈ 8:00 y 20:00, hora peninsular).

string

data_age_seconds

obligatorio

Cualquiera de:

integer
null

integer

>= -9007199254740991 <= 9007199254740991

stale

obligatorio

True si la fuente no respondió y se sirve la última copia buena.

boolean

source

obligatorio

string

attribution

obligatorio

Texto que debes mostrar junto a los datos (CC BY 4.0).

string

license

obligatorio

string formato: uri

web_url

obligatorio

Cualquiera de:

string
null

string formato: uri

Ejemplo

{
  "data": {
    "fuel": "gasoline_95",
    "unit": "L",
    "currency": "EUR",
    "area": {
      "level": "spain"
    }
  }
}

Cabeceras

RateLimit-Policy

string

Política de límites aplicada (borrador IETF).

X-Request-Id

string

Identificador de la petición.

X-Cache

string

Hit, miss o stale.

400

Parámetros no válidos (INVALID_PARAMETER) o desconocidos.

application/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

>= -9007199254740991 <= 9007199254740991

detail

obligatorio

string

code

obligatorio

Código estable del error (p. ej. STATION_NOT_FOUND, RATE_LIMITED).

string

request_id

obligatorio

string

instance

string

Ejemplo^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

404

No encontrado (STATION_NOT_FOUND, PROVINCE_NOT_FOUND…).

application/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

>= -9007199254740991 <= 9007199254740991

detail

obligatorio

string

code

obligatorio

Código estable del error (p. ej. STATION_NOT_FOUND, RATE_LIMITED).

string

request_id

obligatorio

string

instance

string

Ejemplo^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

429

Demasiadas peticiones (RATE_LIMITED). Reintenta tras Retry-After.

application/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

>= -9007199254740991 <= 9007199254740991

detail

obligatorio

string

code

obligatorio

Código estable del error (p. ej. STATION_NOT_FOUND, RATE_LIMITED).

string

request_id

obligatorio

string

instance

string

Ejemplo^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

Cabeceras

Retry-After

integer

503

No disponible temporalmente (TEMPORARILY_UNAVAILABLE). Reintenta tras Retry-After.

application/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

>= -9007199254740991 <= 9007199254740991

detail

obligatorio

string

code

obligatorio

Código estable del error (p. ej. STATION_NOT_FOUND, RATE_LIMITED).

string

request_id

obligatorio

string

instance

string

Ejemplo^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

Cabeceras

Retry-After

integer

Fuente de los datos: Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras). Datos de la API y del servidor MCP con licencia CC BY 4.0: cita Gasolina hoy y la fuente.

Las gasolineras más baratas

Parámetros

Parámetros de consulta

Respuestas

200

Ejemplo

Cabeceras

400

Ejemplogenerated

404

Ejemplogenerated

429

Ejemplogenerated

Cabeceras

503

Ejemplogenerated

Cabeceras

Ejemplo^generated

Ejemplo^generated

Ejemplo^generated

Ejemplo^generated