Histórico de precios

La API tiene tres tipos de histórico: la serie diaria de un territorio (GET /v1/history) o de una gasolinera (GET /v1/stations/{id}/history), de hasta 90 días; la serie mensual de España desde 2005 (GET /v1/history/monthly); y los informes de cada mes cerrado (GET /v1/reports).

Serie diaria de un territorio

Parámetros: fuel (por defecto gasoline_95), days (1–90, por defecto 30) y, opcionalmente, level + code (sin ellos, España).

curl

curl "https://api.preciosgasolina.es/v1/history?level=province&code=28&fuel=diesel&days=30"

JavaScript

const res = await fetch("https://api.preciosgasolina.es/v1/history?" + new URLSearchParams({ level: "province", code: "28", fuel: "diesel", days: "30" }));
const { data } = await res.json();
console.log(`${data.area.name}: ${data.change.pct} % entre ${data.change.from} y ${data.change.to}`);
const serie = data.points.map((p) => [p.date, p.average]); // listo para una gráfica

Python

import requests

data = requests.get(
    "https://api.preciosgasolina.es/v1/history",
    params={"level": "province", "code": "28", "fuel": "diesel", "days": 30},
    timeout=10,
).json()["data"]
print(data["area"]["name"], data["change"]["pct"], "%")
for p in data["points"]:
    print(p["date"], p["average"], p["minimum"], p["maximum"])

Ejemplo ilustrativo: los valores no son precios reales

{
  "data": {
    "area": { "level": "province", "code": "28", "name": "Madrid", "web_url": "https://preciosgasolina.es/precios-gasolineras/comunidad-de-madrid/madrid/" },
    "fuel": "diesel",
    "unit": "L",
    "currency": "EUR",
    "resolution": "day",
    "days": 3,
    "change": { "from": "2026-10-05", "to": "2026-10-07", "first_average": 1.47, "last_average": 1.474, "difference": 0.004, "pct": 0.27 },
    "points": [
      { "date": "2026-10-05", "average": 1.47, "minimum": 1.349, "maximum": 1.659 },
      { "date": "2026-10-06", "average": 1.472, "minimum": 1.349, "maximum": 1.659 },
      { "date": "2026-10-07", "average": 1.474, "minimum": 1.359, "maximum": 1.669 }
    ]
  },
  "meta": { "…": "…" }
}

Serie diaria de una gasolinera

GET /v1/stations/{id}/history devuelve el precio de cada día de los carburantes de una gasolinera (id del Ministerio o slug de su ficha). Con fuel te quedas con uno; days va de 1 a 90 (por defecto 30).

curl "https://api.preciosgasolina.es/v1/stations/12345/history?fuel=diesel&days=60"

La respuesta trae la ficha de la gasolinera en station y una serie por carburante en series[] (fuel, unit y points[] con date y price).

Consulta pesada

El histórico de una gasolinera cuenta como consulta pesada: 30 por minuto por IP. Para muchas gasolineras a la vez, descarga los datos abiertos en lugar de pedirlas una a una.

Serie mensual de España desde 2005

GET /v1/history/monthly devuelve las medias mensuales de la gasolina 95 y el gasóleo en España, con y sin impuestos, desde 2005. La fuente es el Boletín Petrolero de la Unión Europea (Weekly Oil Bulletin, Comisión Europea), no el Ministerio: no son los mismos datos que las medias diarias.

Parámetros opcionales: fuel (gasoline_95 o diesel), from y to en formato AAAA-MM.

curl "https://api.preciosgasolina.es/v1/history/monthly?fuel=diesel&from=2022-01&to=2022-12"

Ejemplo ilustrativo: los valores no son precios reales

{
  "data": {
    "area": { "level": "spain", "code": "es", "name": "España" },
    "resolution": "month",
    "currency": "EUR",
    "unit": "L",
    "source": {
      "name": "Boletín Petrolero de la Unión Europea (Weekly Oil Bulletin), Comisión Europea, DG ENER",
      "url": "https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en",
      "licence": "CC BY 4.0 (Decisión 2011/833/UE de la Comisión)"
    },
    "note": "Medias mensuales del Boletín Petrolero de la UE (precio con impuestos y sin impuestos). No son los mismos datos que las medias diarias del Ministerio.",
    "series": [
      { "fuel": "diesel", "points": [{ "month": "2022-01", "price": 1.401, "price_without_taxes": 0.802 }] }
    ]
  },
  "meta": { "…": "…" }
}

Informes mensuales

• GET /v1/reports: meses cerrados con informe y la media de España de cada mes.
• GET /v1/reports/{month} (AAAA-MM): medias del mes, días más baratos y más caros y provincias ordenadas por precio. Solo hay informes de meses cerrados: pedir el mes en curso devuelve 400.

curl "https://api.preciosgasolina.es/v1/reports/2026-09"

Con el servidor MCP

get_price_history cubre los tres casos: territorio (level + code), gasolinera (station_id) y serie mensual (monthly=true, con from). Ejemplo: «¿Cuánto ha subido el diésel este mes?». Los informes, con get_monthly_report: «¿Cómo fueron los precios en septiembre?».