Exportaciones de vistas guardadas

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

Buscar el ID de la vista guardada

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.

Solicitar un mes de métricas de la vista

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.

{
  "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 }
  }
}

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:

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.

Descripción general

Integraciones

Recursos principales

Analítica

Contenido y conocimiento

Administración

Exportaciones de vistas guardadas

Requisitos previos

Configuración

Qué cifra coincide con el panel

Cómo se aplica la vista

Errores

​Requisitos previos

​Configuración

​Qué cifra coincide con el panel

​Cómo se aplica la vista

​Errores

Requisitos previos

Configuración

Qué cifra coincide con el panel

Cómo se aplica la vista

Errores