Precios de carburantes actualizados cada 15 minutos
Consulta gasolineras de varios países europeos, precios, histórico y cambios recientes en JSON, listo para mapas, alertas y comparadores.
Ultimos avisos
Revisa cambios recientes antes de integrar nuevas consultas o actualizar un cliente existente.
Los endpoints /estaciones/radio y /estaciones/municipio/{idMunicipio} aceptan ahora el parametro fields para ajustar el peso de la respuesta. full mantiene la respuesta completa, current devuelve precios actuales sin campos *_media y basic devuelve solo datos basicos de estacion. En /estaciones/municipio/{idMunicipio} tambien esta disponible prices, que devuelve solo idEstacion y precios actuales.
Ver mas avisos
Ya está disponible Precioil Console para centralizar API keys, revisar consumo de requests y configurar alertas por email desde un único panel.
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 tu API key
Solicita la credencial que usará tu aplicación para conectarse a nuestra API.
Panel de seguimiento
El panel de uso está disponible para integraciones con API keys activas.
Consulta tráfico, consumo, endpoints utilizados, límites y actividad asociada a tus API keys.
La API key y el panel se revisan por separado.
Uso rapido
Cuando recibas la clave, incluyela como cabecera HTTP. Para parametros y respuestas, usa Swagger.
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 funciona 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.