Contenido y guías

La API da acceso al contenido editorial de preciosgasolina.es (guías, artículos del blog y rutas) para que tu app o tu agente pueda responder dudas («¿qué es la gasolina E10?») con un texto revisado y enlazar la fuente. Busca con GET /v1/content y lee una pieza completa con GET /v1/content/{type}/{slug}.

Buscar

Parámetro	Valores
q	Texto a buscar (2–100 caracteres). Sin q, las piezas más recientes.
type	guide (guías), post (blog) o route (rutas).
tag	Una etiqueta exacta (p. ej. e10).
limit	1–50 (por defecto 10).

curl

curl "https://api.preciosgasolina.es/v1/content?q=e10&limit=3"

JavaScript

const { data } = await (await fetch("https://api.preciosgasolina.es/v1/content?" + new URLSearchParams({ q: "e10", limit: "3" }))).json();
for (const item of data.results) console.log(`[${item.type}] ${item.title}\n${item.answer}\n${item.web_url}\n`);

Python

import requests

data = requests.get("https://api.preciosgasolina.es/v1/content", params={"q": "e10", "limit": 3}, timeout=10).json()["data"]
for item in data["results"]:
    print(f'[{item["type"]}] {item["title"]}\n{item["answer"]}\n{item["web_url"]}\n')

Cada resultado trae type, slug, title, description, answer (la respuesta directa de la pieza), published, updated, tags y web_url. data.total es el número de coincidencias.

Ejemplo ilustrativo

{
  "data": {
    "query": "e10",
    "type": null,
    "total": 2,
    "results": [
      {
        "type": "guide",
        "slug": "tipos-de-carburante",
        "title": "Tipos de carburante: gasolina, diésel y gas",
        "description": "Tipos de carburante en las gasolineras de España: gasolina, gasóleo, GLP, GNC, gasóleo B y C y biocombustibles E5, E10 y B7. Qué es cada uno.",
        "answer": "Un combustible es una sustancia que libera energía al quemarse y mueve el motor…",
        "published": "2026-06-15",
        "updated": "2026-10-06",
        "tags": [],
        "web_url": "https://preciosgasolina.es/guias/tipos-de-carburante/"
      }
    ]
  },
  "meta": { "…": "…" }
}

Leer una pieza completa

curl "https://api.preciosgasolina.es/v1/content/guide/tipos-de-carburante"

Devuelve los campos de la búsqueda más heading (el titular de la página), body_markdown (el texto completo en Markdown), faqs (preguntas frecuentes, q y a), sources (fuentes con name y url) y related (slugs relacionados). Las rutas traen además su recorrido, fotos y datos prácticos (ver Dónde repostar en una ruta).

Si el slug no existe, la API responde 404 con GUIDE_NOT_FOUND, ARTICLE_NOT_FOUND (blog) o ROUTE_NOT_FOUND.

Cita siempre la fuente

Si muestras o resumes una guía, enlaza su web_url y menciona a Gasolina hoy. Ver Atribución y licencia.

Impuestos de los carburantes

GET /v1/taxes (sin parámetros) devuelve el IVA de los carburantes, el Impuesto sobre Hidrocarburos por epígrafe, los tramos de la rebaja vigente (Real Decreto-ley 25/2026) y si hay uno en vigor hoy, el régimen de Canarias, los mínimos de la Unión Europea y las fuentes legales. Para aplicarlo a un precio concreto, usa /v1/calc/price-breakdown.

Caché

El contenido cambia cuando se publica en la web, no con los precios: /v1/content, /v1/content/{type}/{slug} y /v1/taxes se cachean 6 horas (Cache-Control: public, max-age=21600).

Con el servidor MCP

search_content («¿Qué es la gasolina E10?») y get_article (una pieza completa). También están como recursos: preciosgasolina://guias/{slug}, preciosgasolina://blog/{slug} y preciosgasolina://rutas/{slug} (ver Recursos y prompts).