# Contenido y guías

> Versión Markdown de https://docs.preciosgasolina.es/guias/contenido-y-guias/ · Actualizado: 2026-10-07 · Índice para LLM: https://docs.preciosgasolina.es/llms.txt

Busca y lee las guías, artículos del blog y rutas de preciosgasolina.es en Markdown, con preguntas frecuentes y fuentes, e impuestos con /v1/taxes.

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**

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

**JavaScript**

```js
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**

```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

```json
{
  "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

```sh
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](https://docs.preciosgasolina.es/guias/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](https://docs.preciosgasolina.es/empezar/atribucion-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`](https://docs.preciosgasolina.es/guias/calculadoras/#desglose-del-precio-impuestos).

## 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](https://docs.preciosgasolina.es/mcp/recursos-y-prompts/)).