API REST
Precios, gasolineras más baratas y cercanas, histórico, carreteras, rutas y calculadoras en JSON, sin clave.
Gratis · sin registro ni clave · solo lectura
API y servidor MCP de precios de carburantes
Gasolina hoy ofrece gratis una API REST y un servidor MCP con los precios oficiales de los carburantes de unas 11.500 gasolineras de España, que publica el Ministerio para la Transición Ecológica y el Reto Demográfico. Sin registro ni clave, de solo lectura, actualizados dos veces al día y con licencia CC BY 4.0 citando la fuente.
- API REST
- https://api.preciosgasolina.es/v1
- OpenAPI 3.1
- https://api.preciosgasolina.es/v1/openapi.json
- Servidor MCP
- https://mcp.preciosgasolina.es/mcp
- Documentación
- https://docs.preciosgasolina.es/
¿Qué puedes usar?
API, servidor MCP, descargas y widget, todo gratis
Servidor MCP
21 herramientas para Claude, ChatGPT, Cursor, VS Code y Claude Code, sin inicio de sesión.
Asistentes de IA
Pregunta a ChatGPT o Claude por el precio de la gasolina con datos oficiales, paso a paso y sin programar.
Datos abiertos
Medias diarias de 90 días y todas las gasolineras con los precios de hoy, en CSV y JSON.
Widget para tu web
El precio medio de hoy de España, tu comunidad o tu provincia con un iframe.
Documentación
Primeros pasos, referencia de cada ruta, herramientas del MCP, límites y atribución.
¿Qué datos ofrecen la API y el servidor MCP?
Los de la web, de unas 11.500 gasolineras, con fecha, fuente y enlace
- Precios de hoyGasolina 95 y 98, gasóleo A y premium, GLP y GNC de cada gasolinera, y AdBlue, gasóleo B, HVO, GNL y gasolinas E10.
- GasolinerasLas más baratas de un territorio, las más cercanas a un punto, la ficha de cada una y un buscador de lugares.
- HistóricoSerie diaria de 90 días por gasolinera y por territorio, y serie mensual de España desde 2005.
- Carreteras y rutasGasolineras de cada carretera, rutas por carretera y dónde repostar en un recorrido.
- ContenidoGuías, artículos del blog, informes mensuales e impuestos de los carburantes.
- CalculadorasCoste de un viaje y del depósito, ahorro, coste por vehículo, AdBlue y desglose del precio.
Cada respuesta incluye la fecha de los datos, la fuente y web_url, el enlace a la página equivalente de preciosgasolina.es, para que una aplicación o un asistente pueda citar y enlazar. Canarias, Ceuta y Melilla van aparte en los rankings de las más baratas, porque no pagan el Impuesto sobre Hidrocarburos. El servidor MCP tiene 21 herramientas.
¿Qué condiciones de uso tienen?
Licencia CC BY 4.0, con atribución y enlace
Atribución obligatoria
Fuente: Gasolina hoy (preciosgasolina.es), con datos del Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras).
Añade un enlace a preciosgasolina.es (o a la página de web_url) y la fecha de los datos. Detalles en atribución y licencia.
- Gratis y sin claveSin registro, sin clave y de solo lectura.
- Límites por IP120 peticiones por minuto en la API y 60 mensajes por minuto en el MCP. Ver los límites.
- Licencia CC BY 4.0La misma que los datos abiertos: Creative Commons Reconocimiento 4.0 Internacional (CC BY 4.0).
Preguntas frecuentes
¿La API de precios de carburantes es gratis?
Sí. La API REST y el servidor MCP de Gasolina hoy son gratuitos, no piden registro ni clave y son de solo lectura. Para que funcionen bien para todos hay límites por IP: 120 peticiones por minuto en la API y 60 mensajes por minuto en el servidor MCP.
¿De dónde salen los precios?
Del Geoportal de Gasolineras del Ministerio para la Transición Ecológica y el Reto Demográfico. Son los precios, con impuestos incluidos, que las gasolineras de venta al público de España (unas 11.500) comunican al Ministerio.
¿Cada cuánto se actualizan los datos?
Dos veces al día, hacia las 8:00 y las 20:00 (hora peninsular). No son precios en tiempo real: cada respuesta indica la fecha de la última actualización y la hora prevista de la siguiente.
¿Qué diferencia hay entre la API, el servidor MCP y los datos abiertos?
La API REST responde en JSON a consultas concretas (las gasolineras más baratas de una provincia, las cercanas a un punto, el histórico de una gasolinera). El servidor MCP ofrece esas consultas como herramientas para asistentes de IA como Claude o ChatGPT. Los datos abiertos son archivos CSV y JSON para descargar todo de una vez.
¿Con qué licencia puedo usar los datos?
Con licencia CC BY 4.0, también con fines comerciales, citando la fuente con un enlace a preciosgasolina.es. Texto de atribución: «Fuente: Gasolina hoy (preciosgasolina.es), con datos del Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras).»
¿Dónde está la documentación de la API?
En docs.preciosgasolina.es: primeros pasos, referencia de cada ruta, cómo conectar el servidor MCP, sus herramientas, los límites y la atribución. La especificación OpenAPI 3.1 está en https://api.preciosgasolina.es/v1/openapi.json.
Fuente de los precios: Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras), actualizados dos veces al día, hacia las 8:00 y las 20:00 (hora peninsular). Página revisada el .