Camper Fuel API

Gasolineras de España con precio actual y datos de accesibilidad para autocaravanas/campers (altura de marquesina, acceso para vehículos altos).

Base URL https://camper-fuel-api.vangas.workers.dev   openapi.json · buscador

Autenticación

Los endpoints de lectura son públicos. A través de RapidAPI, tu clave de RapidAPI gestiona el acceso y las cuotas.

Niveles de accesibilidad

Valor	Significado
verificada	Conocemos la altura real de la marquesina (fuente: comunidad, taller u OSM).
probable	Indicio automático de acceso: reposta gas de camión (GNL/GNC) o está en autovía. Sin medir.
desconocida	No tenemos datos de accesibilidad.

Regla: nunca afirmamos que "cabe" sin dato. altura_min descarta solo lo que se sabe que no pasa; lo desconocido se incluye marcado como tal.

GET /v1/estaciones

Busca gasolineras. Ordena por precio si indicas carburante; si no, por cercanía.

Parámetro	Tipo	Descripción
lat, lon	número	Centro de la búsqueda (grados). Van juntos.
radio_km	número	Radio máximo. Por defecto 10.
carburante	texto	Código (ver /v1/carburantes), p. ej. gasoleo_a.
precio_max	número	Precio máximo del carburante elegido.
altura_min	número	Altura de la camper (m). Descarta lo que no quepa.
solo_accesibles	bool	true: solo verificadas o con indicio probable.
solo_verificadas	bool	true: solo con altura verificada.
limit	número	Máximo de resultados (por defecto 10, tope 100).

Ejemplo

curl "https://camper-fuel-api.vangas.workers.dev/v1/estaciones?lat=37.8457&lon=-4.7974&radio_km=15&carburante=gasoleo_a&altura_min=3&limit=3"

{
  "meta": { "total": 46, "devueltos": 3, "atribucion": "Datos: Ministerio..." },
  "resultados": [
    {
      "id": "16073", "rotulo": "PETROPRIX", "municipio": "Córdoba",
      "direccion": "CALLE INGENIERO JUAN DE LA CIERVA, 44",
      "lat": 37.846361, "lon": -4.791722,
      "precios": { "gasoleo_a": 1.769, "gasolina_95_e5": 1.659 },
      "distancia_km": 0.5,
      "accesibilidad": "verificada",
      "indicios_acceso": { "probable": false, "motivos": [] },
      "camper": { "altura_max_m": 3.2, "altura_fuente": "streetview", "notas_camper": null }
    }
  ]
}

GET /v1/estaciones/{id}

Una gasolinera por su id (IDEESS del Ministerio).

curl "https://camper-fuel-api.vangas.workers.dev/v1/estaciones/16073"

GET /v1/carburantes

Lista de códigos de carburante válidos.

curl "https://camper-fuel-api.vangas.workers.dev/v1/carburantes"

GET /health

Estado del servicio y fecha del último volcado en caché.

Licencia y atribución

Los precios y estaciones provienen de los datos abiertos del Ministerio para la Transición Ecológica y el Reto Demográfico (España). La atribución es obligatoria al usar la API. Los datos de accesibilidad camper son de Camper Fuel y su comunidad.