Precios de carburantes actualizados cada 15 minutos
Toda la información de carburantes que necesitas en una sola API, más de 50.000 estaciones europeas, precios actualizados cada 15 minutos e histórico de cambios listo para usar.
Ultimos avisos
Revisa cambios recientes antes de integrar nuevas consultas o actualizar un cliente existente.
Ya está disponible Precioil Console para centralizar API keys, revisar consumo de requests y configurar alertas por email desde un único panel.
Ver mas avisos
Actualizado /cambios/precios como endpoint ligero recomendado para consultas recurrentes de cambios recientes, por ejemplo cada media hora, evitando tener que reconsultar estaciones completas de golpe. La forma recomendada de uso es minutes, con filtros opcionales por estacion y combustible, modo soloIds y rango maximo de 1440 minutos. Si necesitas todos los eventos de un periodo, puedes usar /cambios/precios/historico.
Disponible el endpoint /fuel-types para consultar la relacion entre idFuelType y fuelTypeName.
Se han reducido claves con valor null en varios endpoints de estaciones para disminuir trafico sin cambiar la estructura general de respuesta.
Todas las rutas disponibles
Listado compacto de endpoints registrados en la API. Abre cada grupo para ver las rutas sin alargar demasiado la pagina.
Estaciones y busqueda geografica Endpoints de estaciones que aparecen documentados en Swagger. 5 rutas
/estaciones/radioRetorna estaciones de servicio dentro de un radio especifico./estaciones/municipio/{idMunicipio}Estaciones filtradas por municipio./estaciones/cerca/{idEstacion}Estaciones cercanas a una estacion concreta./estaciones/detalles/{idEstacion}Detalle de una estacion concreta./estaciones/historico/{idEstacion}Historico de precios de una estacion.Territorio y catalogos Datos auxiliares documentados para montar selectores y filtros. 3 rutas
/provinciasListado de provincias disponibles./municipios/provincia/{idProvincia}Municipios de una provincia./fuel-typesTipos de combustible soportados por la API.Precios, historicos y cambios Consultas documentadas para analisis, paneles y seguimiento de variaciones. 4 rutas
/precioMedioDiarioPrecio medio diario./cambios/preciosCambios de precio recientes./cambios/precios/historicoHistorico de cambios de precios./precios/medios/provincia/{idProvincia}Precios medios agrupados por provincia.Solicita una API key
No necesitas registrarte en Console ni indicar endpoints. Validamos tu email y revisamos la solicitud.
Como usar tu API key
Cuando recibas la clave, incluyela en cada peticion como cabecera HTTP. No la pongas en la URL.
curl "https://api.precioil.es/estaciones/detalles/1" -H "X-API-Key: TU_API_KEY"
curl "https://api.precioil.es/estaciones/detalles/1" -H "Authorization: Bearer TU_API_KEY"
- En backend o scripts usa normalmente
X-API-Keydesde tu servidor. - En navegador usa una key de tipo browser; solo funcionara desde un origin autorizado.
- Si la key tiene IPs permitidas, las peticiones deben salir desde esas IPs.
¿Tienes dudas sobre la API?
Abre el formulario y cuéntanos tu caso. Revisamos endpoints, parámetros, errores y cambios recientes.