Ir al contenido
Docs

Gasolineras cerca de unas coordenadas

GET
/v1/stations/nearby
curl --request GET \
  --url 'https://api.preciosgasolina.es/v1/stations/nearby?lat=1&lng=1&radius_km=5&fuel=gasoline_95&sort=price&limit=10'

Gasolineras con precio del carburante a menos de radius_km, ordenadas por precio (sort=price) o por distancia (sort=distance).

Herramienta MCP equivalente: find_fuel_near.

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

Parámetros

Sección titulada «Parámetros»

Parámetros de consulta

Sección titulada «Parámetros de consulta»
lat
obligatorio
number
>= 27.4 <= 44

Latitud WGS84 (España, Canarias incluidas).

lng
obligatorio
number
>= -18.4 <= 4.6

Longitud WGS84.

radius_km
number
por defecto: 5 > 0 <= 50

Radio en km (máximo 50).

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.

sort
string
por defecto: price
Valores permitidos: price distance
limit
integer
por defecto: 10 >= 1 <= 50

Número de resultados (1–50).

open_24h
Cualquiera de:
boolean
brand
string
>= 1 caracteres <= 120 caracteres /^[a-z0-9-]+$/

Slug de la marca (p. ej. repsol).

Respuestas

Sección titulada «Respuestas»

200

Sección titulada «200»

Correcto: sobre { data, meta }.

Tipo de contenidoapplication/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
center
obligatorio
object
lat
obligatorio
number
lng
obligatorio
number
radius_km
obligatorio
number
sort
obligatorio
string
stations
obligatorio
Array<object>
object
id
obligatorio

Identificador del Ministerio (IDEESS).

integer
>= -9007199254740991 <= 9007199254740991
name
obligatorio
string | null
brand
obligatorio
Cualquiera de:
object
slug
obligatorio
string
name
obligatorio
string | null
address
obligatorio
string | null
postal_code
obligatorio
string | null
municipality
obligatorio
object
id
obligatorio
Cualquiera de:
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
>= -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 formato: uri
Ejemplo
{
  "data": {
    "fuel": "gasoline_95",
    "unit": "L",
    "currency": "EUR"
  }
}

Cabeceras

Sección titulada «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

Sección titulada «400»

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

Tipo de contenidoapplication/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
Ejemplogenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

404

Sección titulada «404»

No encontrado (STATION_NOT_FOUND, PROVINCE_NOT_FOUND…).

Tipo de contenidoapplication/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
Ejemplogenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

429

Sección titulada «429»

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

Tipo de contenidoapplication/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
Ejemplogenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

Cabeceras

Sección titulada «Cabeceras»
Retry-After
integer

503

Sección titulada «503»

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

Tipo de contenidoapplication/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
Ejemplogenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "instance": "example"
}

Cabeceras

Sección titulada «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.

© 2026 ONETOUCH SA de CVpreciosgasolina.esTérminos de usoAviso legalPrivacidadllms.txtOpenAPI