> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Exportaciones de vistas guardadas

> Obtén periódicamente las métricas de una vista guardada del panel en Snowflake, BigQuery o cualquier almacén de datos

AthenaHQ no incluye un conector nativo para almacenes de datos. Para mantener una tabla de tu almacén sincronizada con una vista guardada, ejecuta una tarea programada en tu entorno que solicite a los endpoints de métricas esa vista y un intervalo de fechas y, después, escriba el resultado en tu almacén. Los endpoints aplican los filtros de la vista del mismo modo que el panel, por lo que las cifras coinciden con las que muestra el panel para la misma vista y las mismas fechas.

## Requisitos previos

* Una clave de API de AthenaHQ con acceso al sitio web (Organización → pestaña API). Consulta la página de [Autenticación](https://docs.athenahq.ai/es/api-reference/authentication.md). Para una tarea programada, la opción más segura es una clave dedicada con acceso limitado a este sitio web.
* El `website_id` sobre el que quieres informar. Obtenlo con `GET /api/v1/websites`.
* Una vista guardada en ese sitio web, creada en el panel.

## Configuración

**1. Buscar el ID de la vista guardada**

```bash theme={null}
curl "https://api.athenahq.ai/api/v1/saved-views?website_id=YOUR_WEBSITE_ID" \
  -H "x-api-key: YOUR_API_KEY"
```

Copia el `id` de la vista cuyo `name` te interesa. El ID se mantiene cuando alguien edita la vista en el panel, por lo que la exportación sigue esos cambios.

**2. Solicitar un mes de métricas de la vista**

```bash theme={null}
curl -X POST https://api.athenahq.ai/api/v1/metrics/mention-rate/cumulative \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_id": "YOUR_WEBSITE_ID",
    "filters": {
      "saved_view_id": "YOUR_SAVED_VIEW_ID",
      "start_date": "2026-08-01",
      "end_date": "2026-08-31"
    }
  }'
```

La respuesta contiene una entrada por marca: la tuya (`is_self: true`) y cada competidor que selecciona la vista.

```json theme={null}
{
  "data": {
    "Your Brand": { "mention_rate": 42.3, "relative_mention_rate": 61.8, "is_self": true },
    "Competitor A": { "mention_rate": 24.9, "relative_mention_rate": 36.4, "is_self": false }
  }
}
```

**3. Programar la tarea**

Ejecuta la solicitud una vez al mes para el mes que acaba de finalizar y añade las filas, junto con el mes, a tu tabla. Por ejemplo, en Python:

```python theme={null}
import datetime as dt

import requests

today = dt.date.today()
end = today.replace(day=1) - dt.timedelta(days=1)  # last day of last month
start = end.replace(day=1)

response = requests.post(
    "https://api.athenahq.ai/api/v1/metrics/mention-rate/cumulative",
    headers={"x-api-key": API_KEY},
    json={
        "website_id": WEBSITE_ID,
        "filters": {
            "saved_view_id": SAVED_VIEW_ID,
            "start_date": start.isoformat(),
            "end_date": end.isoformat(),
        },
    },
    timeout=60,
)
response.raise_for_status()

rows = [
    {"month": start.isoformat(), "brand": name, **values}
    for name, values in response.json()["data"].items()
]
# Write `rows` to your warehouse table, e.g. with the Snowflake connector's
# write_pandas or an INSERT through your usual loading tool.
```

## Qué cifra coincide con el panel

La tarjeta Porcentaje de menciones del panel muestra de forma predeterminada el porcentaje **relevante**. En la API es `relative_mention_rate`: las menciones de la marca divididas entre las respuestas que mencionan tu marca o uno de los competidores de la vista. `mention_rate` es el modo **absoluto** de la tarjeta: las menciones divididas entre todas las respuestas de la vista. Lee la entrada con `is_self: true` para tu propia marca.

Como el porcentaje relevante cuenta las respuestas que mencionan a cualquiera de los competidores de la vista, cambiar la lista de competidores de la vista también cambia tu propio porcentaje relevante, tanto en el panel como aquí.

## Cómo se aplica la vista

* **Fechas.** `start_date` y `end_date` determinan el intervalo; se ignora el intervalo de fechas guardado con la vista. Envía fechas simples (`YYYY-MM-DD`). `end_date` es inclusiva.
* **Valores predeterminados.** Como en el panel, la vista solo cuenta las consultas activas e incluye todos los modelos, salvo que indique otra cosa. Una solicitud sin `saved_view_id` conserva los valores predeterminados de la API, que incluyen las consultas en pausa.
* **Sustituciones.** Cualquier filtro que envíes junto a `saved_view_id` sustituye el valor de la vista para ese campo. Por ejemplo, `"models": ["chatgpt"]` lee la vista solo para ChatGPT.
* **Filtros de otras páginas.** Las páginas Consultas, Respuestas y Fuentes comparten las vistas guardadas. Los filtros que solo utilizan esas páginas, como el sentimiento o las etiquetas de fuentes, no cambian las métricas del panel ni las de aquí.
* **Todas las métricas.** El mismo `saved_view_id` funciona en todos los endpoints de métricas: porcentaje de menciones, cuota de voz, porcentaje de citas y posición, tanto acumuladas como en series temporales. Las herramientas de métricas de MCP (`get_mention_rate_cumulative` y las demás) también lo aceptan.

## Errores

| Estado | Significado | Qué hacer |
| - | - | - |
| `404` No se ha encontrado la vista guardada | El ID no corresponde a una vista guardada de `website_id`. | Vuelve a listar las vistas del sitio web; puede que la vista se haya eliminado. |
| `400` La vista guardada «…» utiliza filtros que la API no puede aplicar | La vista utiliza un filtro que la API no puede reproducir, como «Modelos no es ninguno de». El mensaje lo identifica. | Envía el filtro indicado explícitamente (por ejemplo, `filters.models`) para sustituir el valor de la vista, o cambia la vista en el panel. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.