Datos y cobertura

Los precios de la API y del servidor MCP son los que las gasolineras de venta al público de España comunican al Ministerio para la Transición Ecológica y el Reto Demográfico, que los publica en el Geoportal de Gasolineras y en su servicio de datos abiertos. Gasolina hoy los recoge dos veces al día, calcula medias, rankings e histórico y los sirve con una forma estable.

Qué cubre

Gasolineras	Unas 11.500 gasolineras de venta al público de toda España, Canarias, Ceuta y Melilla incluidas.
Carburantes	Gasolina 95 E5, gasolina 98 E5, gasóleo A, gasóleo premium, GLP (autogás) y GNC.
Otros productos	AdBlue, gasóleo B, HVO, GNL y gasolinas 95 y 98 E10, solo de las gasolineras que comunican su precio.
Datos de cada gasolinera	Nombre, marca, dirección, código postal, municipio, provincia, comunidad, coordenadas, horario y si abre 24 horas.
Territorios	Comunidades autónomas, provincias y municipios (con sus medias y rankings).
Histórico diario	Hasta 90 días por territorio y por gasolinera.
Serie mensual	España desde 2005 (gasolina 95 y gasóleo, con y sin impuestos), del Boletín Petrolero de la Unión Europea.
Carreteras	Autovías, autopistas y nacionales con al menos 8 gasolineras localizadas.
Contenido	Guías, artículos del blog y rutas por carretera de preciosgasolina.es.

Cómo se calculan los datos derivados

• Medias, mínimos y máximos de cada territorio: con las gasolineras que tienen precio de ese carburante ese día (el número va en stations).
• Mediana: además de la media, en /v1/prices.
• Variación diaria (change_vs_previous_day_pct) y frente a España (vs_spain_pct): en porcentaje.
• Distritos y barrios: el Ministerio solo da el municipio; la web los asigna por coordenadas, pero la API trabaja con comunidades, provincias y municipios.
• Carreteras: cada gasolinera se asigna a una carretera por sus coordenadas, con un índice que se regenera de vez en cuando (las gasolineras nuevas pueden tardar en aparecer).
• Calculadoras: las mismas fórmulas que las herramientas de la web.

Qué no incluye

Precaución

• No hay datos en tiempo real ni por horas: son dos actualizaciones al día. Ver Frescura de los datos.
• No hay puntos de recarga eléctrica: solo gasolineras y sus carburantes.
• No hay precios de gasolineras que no los comunican ni de las de uso privado (solo venta al público).
• No hay descuentos de tarjetas, apps o fidelización: es el precio que la gasolinera comunica.
• Los productos (AdBlue, HVO…) solo aparecen en las gasolineras que comunican su precio, no en todas las que los venden.

Canarias, Ceuta y Melilla

No pagan el Impuesto sobre Hidrocarburos (tienen regímenes propios), así que sus precios son más bajos por fiscalidad. Están en la API como cualquier otro territorio, pero en los rankings de toda España van aparte salvo include_low_tax=true, y sus gasolineras y comunidades llevan low_tax_area: true.

Exactitud

Los precios son los que comunica cada gasolinera: Gasolina hoy no los modifica, pero tampoco puede garantizar que coincidan con el surtidor en cada momento (una gasolinera puede cambiar el precio entre dos actualizaciones o comunicarlo con retraso). Muestra siempre la fecha de los datos. Las condiciones están en los términos de uso.

Descargas completas

Si necesitas todas las gasolineras con sus precios de hoy o las medias diarias de 90 días de todos los territorios, usa los datos abiertos de la web (CSV y JSON, misma licencia) en lugar de recorrer la API.