> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/desarrolladores/api.md). # API de Insights La API de AirOps Insights: una API de seguimiento de AEO y citas de IA con acceso programático a la tasa de menciones, cuota de voz, citas y rendimiento de página, para paneles personalizados, ETL e informes. La API de Insights es la API de AirOps para la optimización de motores de respuesta (AEO) y el seguimiento de citas de IA, y te da acceso programático a los mismos datos que ves en tu panel de Insights: tasas de menciones, citas, share of voice, rendimiento de páginas y más. Úsala para crear paneles personalizados, automatizar informes o canalizar datos de AEO a tu almacén de datos junto con tus otras métricas de marketing. Todos los endpoints de Insights viven bajo `/public_api/brand_kits` y requieren un Brand Kit con AEO habilitado. Para la configuración de autenticación, consulta la [Referencia de la API](https://docs.airops.com/api-reference). *** ## Modelo de datos El Brand Kit es el recurso raíz. Todo lo demás se conecta a él: | Recurso | Qué contiene | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Analíticas** | Consultas flexibles de métricas: tasa de menciones, share of voice, tasa de citas, sentimiento y más, segmentadas por proveedor, competidor, tema, país o fecha | | **Páginas web** | Tus páginas rastreadas con citas de AEO, Google Search Console y métricas de GA4 combinadas | | **Prompts** | Preguntas de IA que se están rastreando, con tasas y tendencias de menciones/citas | | **Citas** | URLs citadas en respuestas de IA, con puntuación de influencia y sentimiento | | **Competidores** | Dominios que estás supervisando para análisis competitivo | | **Temas** | Categorías que organizan tus prompts | | **Personas** | Perfiles de audiencia usados para el análisis de prompts | *** ## Inicio rápido ### 1. Encuentra tu Brand Kit ```bash curl -X POST https://api.airops.com/public_api/brand_kits/list \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "filters": [{ "field": "aeo_enabled", "operator": "EQ", "value": true }] }' ``` La respuesta incluye el id de tu Brand Kit `id` — úsalo en todas las llamadas posteriores. ### 2. Consulta tu visibilidad de IA ```bash curl -X POST https://api.airops.com/public_api/brand_kits/{brand_kit_id}/analytics \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "metrics": ["mention_rate", "share_of_voice", "citation_rate"], "dimensions": ["date"], "grain": "weekly", "start_date": "2026-01-01", "end_date": "2026-02-18" }' ``` ### 3. Encuentra páginas que necesitan atención ```bash curl -X POST https://api.airops.com/public_api/brand_kits/{brand_kit_id}/web_pages/list \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "smart_filter": "losing_ai_visibility", "per_page": 10, "sort": "-citations_count" }' ``` Tres llamadas y tendrás: la tendencia de tu visibilidad, tu posición competitiva y qué páginas necesitan trabajo. *** ## Endpoints ### ¿Qué endpoint necesito? | Quiero... | Usar | | -------------------------------------------------------- | ------------------------------------- | | Obtener mis métricas generales de visibilidad de IA | Analíticas | | Comparar con los competidores a lo largo del tiempo | Analíticas con `competidor` dimensión | | Desglosar el rendimiento por proveedor de IA | Analíticas con `proveedor` dimensión | | Encontrar páginas que están perdiendo citas o posiciones | Páginas web con filtros inteligentes | | Obtener datos de AEO + SEO + tráfico por página | Páginas web | | Ver qué preguntas de IA mencionan mi marca | Prompts | | Ver qué URLs están siendo citadas | Citas | ### Analíticas `POST /public_api/brand_kits/{id}/analytics` El endpoint más flexible. Elige cualquier combinación de métricas y dimensiones para construir exactamente la consulta que necesitas. **Métricas:** | Métrica | Descripción | | --------------------------------------------------------------- | ------------------------------------------------------------- | | `mention_rate` | % de respuestas de IA que mencionan tu marca (0-100) | | `share_of_voice` | Tus menciones / (las tuyas + las de los competidores) (0-100) | | `citation_rate` | % de respuestas de IA que citan tus páginas (0-100) | | `citation_share` | Tus citas / total de citas (0-100) | | `citation_count` | Número absoluto de citas | | `sentiment_score` | Sentimiento de las menciones de la marca (0-100) | | `Posición media` | Posición media en las listas de respuestas de IA | | `Total de respuestas de IA analizadas` | first\_mention\_rate | | `% de las respuestas en las que se te menciona primero (0-100)` | % de las respuestas en las que se te menciona primero (0-100) | **Dimensiones** (hasta 3 por consulta): `date`, `proveedor`, `topic`, `country`, `persona`, `domain`, `competidor`, `domain_category` **Granularidad temporal:** `diaria` (máx. 120 días), `semanal` (máx. 180 días), `mensual` (máx. 365 días), `total` (máx. 365 días) **Filtros:** `providers`, `topics`, `countries`, `personas`, `brand_mentioned` **Límites:** Máximo 1.000 filas por consulta. Predeterminado: 100. ### Páginas web `POST /public_api/brand_kits/{id}/web_pages/list` Tus páginas rastreadas combinan datos de citas, búsqueda, tráfico y Agent Analytics en una sola respuesta: | Fuente | Métricas | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | **AEO** | `citations_count`, `citation_rate`, `prompts_count` | | **Google Search Console** | `clicks`, `impressions`, `ctr`, `position` | | **Google Analytics 4** | `tráfico`, `sessions`, `interacción`, `average_session_engagement` | | **Agent Analytics** | `user_browse` (visitas de agentes de IA), `ai_training` (rastreo de entrenamiento), `ai_search` (rastreo de búsqueda web) | Los campos de Agent Analytics son conteos filtrables y ordenables para el intervalo de fechas seleccionado. Conecta primero Agent Analytics para recopilar estos datos. Estos campos no incluyen variantes de cambio período sobre período. `total_crawls` no es un campo en este endpoint; usa el endpoint de Agent Analytics de abajo para ese cálculo. Las cuentas del plan gratuito reciben **402 Pago requerido** del endpoint de Páginas web. **Filtros inteligentes** detectan oportunidades comunes: | Filtro | Qué encuentra | | ----------------------- | ---------------------------------------------------- | | `almost_page_one` | Páginas con posicionamiento #10-20 | | `losing_clicks` | Clics en descenso con posiciones estables | | `rankings_slipping` | La posición en el SERP está disminuyendo en 90 días | | `losing_ai_visibility` | Páginas que pierden citas de IA | | `citation_rate_decline` | Pérdida de autoridad de IA a pesar de un SEO estable | 26+ campos filtrables con operadores: `EQ`, `NEQ`, `GT`, `LT`, `GEQ`, `LEQ`, `CONTAINS`, `STARTS_WITH`, `IN` ### Agent Analytics `POST /public_api/brand_kits/{id}/agent_analytics/list` Devuelve conteos diarios de solicitudes para las páginas rastreadas del Brand Kit después de que [conectes Agent Analytics](/docs/es/insights/onsite/traffic.md). Cada fila contiene `date`, `platform`, `crawl_type`, y `count`. Las filas sin solicitudes se omiten. Proporciona `start_date` y `end_date` para elegir un período. Puedes filtrar por `platform`, `crawl_type`, o un `web_page_id`, y ordenar por `date` o `count` (`-count` para obtener primero los mayores). La paginación predeterminada es de 25 filas y admite hasta 100 por página. Lee cada página antes de calcular totales. | Resultado | Cálculo | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | Agent Analytics **Total de rastreos** | Suma `ai_search` y `ai_training` para los motores rastreados. | | **Visitas de agentes de IA** | Suma `user_browse` para los motores rastreados. | | **Motor de rastreo principal** | El motor rastreado con el total combinado más alto de `ai_search` y `ai_training` conteo. | | **Desglose por tipo de rastreo** | Cada uno de `ai_search` y `ai_training` como porcentaje de su total combinado para los motores rastreados. | | **Desglose por motor** | Agrupa por motor rastreado y suma los rastreos de entrenamiento, los rastreos de búsqueda web, su total combinado y las Visitas de agentes de IA. | | **Actividad de rastreo vs. visitas de agentes de IA** | Agrupa por fecha y tipo de rastreo en todas las plataformas devueltas, incluyendo `otras` solicitudes. | | **Visitas de agentes de IA a lo largo del tiempo** | Agrupa `user_browse` por fecha y motor rastreado. | Los motores rastreados para estos cálculos son `chat_gpt`, `perplexity`, `gemini`, `google_ai_mode`, y `claude`. La respuesta también incluye otras plataformas, como rastreadores de búsqueda genéricos. Para que coincida con la **tabla de** Páginas, **Total de rastreos** de una página, filtra por su `web_page_id` y suma todas las filas, incluidas todas las plataformas y tipos de rastreo. Esto difiere del total de rastreos solo de IA del resumen de Agent Analytics. {% hint style="info" %} El endpoint diario sigue el límite de fecha de la pestaña de Agent Analytics: una solicitud exactamente a medianoche después de `end_date` puede aparecer como una fila con la fecha del día siguiente. Excluye las filas con fecha posterior a `end_date` al hacer coincidir con la tabla de Páginas. {% endhint %} ### Prompts `POST /public_api/brand_kits/{id}/prompts/list` · `GET /public_api/brand_kits/{id}/prompts/{id}` Preguntas de IA que se están rastreando para tu marca. Cada prompt incluye `mention_rate`, `citation_rate`, y tendencias período sobre período (`mention_rate_trend`, `citation_rate_trend`). Filtra por `texto`, `brand_mentioned`, `topic_id`, `prompt_volume`, `mention_rate`, `citation_rate`. Limita las métricas a proveedores, países o personas específicos usando filtros de contexto. ### Intención de respuesta Las respuestas de lista y detalle exponen el campo de solo lectura del prompt `intent_stage`: `awareness`, `consideration`, `evaluation`, o `purchase`. Es `null` cuando la clasificación no está disponible. El mismo campo está disponible a través de las herramientas de respuestas de MCP. ### Citas `POST /public_api/brand_kits/{id}/citations/list` · `POST /public_api/brand_kits/{id}/citations/show` URLs citadas en respuestas de IA, cada una puntuada con un `puntuación de influencia` (0-100) que tiene en cuenta la autoridad del dominio, la frecuencia de citación y la relevancia. Incluye `brand_sentiment` (positivo/neutral/negativo) y `domain_category`. Ordenar por `citation_count`, `citation_share`, `citation_rate`, o `puntuación de influencia`. Para citas y dominios, `prompt_type` con `EQUALS` y valor `brand` o `category` describe el prompt. `brand_mentioned` con `EQ` y valor `true` o `false` describe si la página que cita menciona tu marca. Estos filtros pueden combinarse: ```json { "filters": [ { "field": "prompt_type", "operator": "EQUALS", "value": "category" }, { "field": "brand_mentioned", "operator": "EQ", "value": true } ] } ``` Los anteriores `brand_mentioned EQUALS brand/category` y `brand_referenced EQ true/false` los alias siguen siendo aceptados. Los filtros nuevos y explícitos tienen prioridad si ambas formas están presentes. En el endpoint de Prompts, `brand_mentioned EQ true/false` sigue describiendo el texto del prompt. Las respuestas de lista y detalle de citas incluyen un campo `social` cuando existe metadatos sociales compatibles. Identifica la plataforma y contiene `content` y `account` objetos con metadatos, métricas y estado de sincronización. `social` es `null` cuando no existe ningún registro social compatible; `social.account` puede ser `null` incluso cuando hay contenido presente. Los metadatos pueden estar incompletos mientras la recopilación está pendiente o después de una recopilación fallida. Los metadatos del contenido de YouTube también incluyen `duration_seconds`, `format`, y `sponsorship_status`. La duración puede ser `null`; el formato y el estado de patrocinio usan `unknown` cuando la información no está disponible. ### Anuncios observados `POST /public_api/aeo/brand_kits/{id}/ads/list` · `POST /public_api/aeo/brand_kits/{id}/ads/show` Consulta los anuncios de ChatGPT y Google AI Mode que AirOps observa para los prompts rastreados del Brand Kit. Estos endpoints usan los mismos datos de anuncios observados que [Biblioteca de anuncios](/docs/es/insights/ads.md#ad-library) y no requieren una conexión de cuenta de anuncios de ChatGPT. Requieren acceso a los datos de anuncios del Brand Kit. | Endpoint | Devuelve | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Lista** | Una fila por proveedor y creatividad observada, detalles del anunciante, título y cuerpo, apariciones, respuestas distintas, prompts, frecuencia e historial de observación | | **Mostrar** | Detalles de una creatividad específica del proveedor, imagen y URL de destino, anunciante e historial de observación | Pasa el `observed_creative_id` como `id` y su `proveedor` como un único elemento `providers` array al endpoint show. Esto identifica un creativo observado en esa plataforma, no un recurso en tu cuenta de anuncios conectada. El mismo creativo puede tener filas de lista separadas para distintas plataformas. Las listas incluyen ambos proveedores compatibles por defecto. Usa `providers: ["chat_gpt"]` o `providers: ["google_ai_mode"]` para seleccionar uno. Las solicitudes de show usan ChatGPT por defecto cuando se omite y requieren exactamente un proveedor cuando se especifica. Los filtros de la lista incluyen `topic_id`, `prompt_id`, y `prompt_type` (`EQUALS` con `brand` o `category`). El antiguo `brand_mentioned` alias de tipo de prompt todavía se acepta. Delimita las solicitudes con `start_date`, `end_date`, `providers`, `countries`, `personas`, y `tags`. La lista admite paginación y selección de campos. `apariciones` cuenta las ocurrencias del anuncio; `respuestas` cuenta las respuestas recopiladas distintas que contienen el anuncio. `frequency` es el porcentaje de respuestas rastreadas en el alcance que lo contienen. `first_seen` y `last_seen` cubren el historial de observación del anuncio, y `days_active` es el intervalo inclusivo entre ambos. El endpoint show no devuelve la aparición, la respuesta, el prompt ni las métricas de frecuencia con ventana de la lista. Estas observaciones no establecen una cobertura total del mercado, el gasto del anunciante ni la intención de segmentación. Las herramientas MCP equivalentes son [list\_aeo\_ads y get\_aeo\_ad](/docs/es/desarrolladores/tools.md#list_aeo_ads). ### Competidores, Temas, Personas `POST /public_api/brand_kits/{id}/competitors/list` · `GET .../competitors/{id}` `POST /public_api/brand_kits/{id}/topics/list` · `GET .../topics/{id}` `POST /public_api/brand_kits/{id}/personas/list` · `GET .../personas/{id}` Datos de referencia para la configuración de tu Brand Kit. Usa estos IDs al filtrar otros endpoints. *** ## Patrones comunes ### Paginación Todos los endpoints de lista usan paginación basada en desplazamiento con un máximo de 100 elementos por página. ```json { "page": 1, "per_page": 100 } ``` Las respuestas incluyen `meta.total_count` y `meta.total_pages`. Recorre hasta que `page >= total_pages`. ### Filtrado Pasa un array de `filters` en el cuerpo de la solicitud: ```json { "filters": [ { "field": "citation_rate", "operator": "GT", "value": 5 }, { "field": "brand_mentioned", "operator": "EQ", "value": true } ] } ``` | Escribe | Operadores | | -------- | ------------------------------------- | | Texto | `EQUALS`, `CONTAINS`, `STARTS_WITH` | | Numérico | `EQ`, `NEQ`, `GT`, `LT`, `GEQ`, `LEQ` | | Conjunto | `IN` | ### Ordenación Pasa un array de `sort` cadena. Antepon `-` para orden descendente: ```json { "sort": "-citation_rate" } ``` ### Selección de campos Pasa un array de `fields` array para limitar los campos devueltos: ```json { "fields": ["url", "citations_count", "clicks", "position"] } ``` ### Intervalos de fechas Los endpoints de métricas aceptan `start_date` y `end_date` en `YYYY-MM-DD` formato. Por defecto, son los últimos 30 días si se omite. * `end_date` debe ser anterior a hoy * Las métricas de GSC y GA4 tienen un retraso de 4 días ### Disponibilidad de datos Cada respuesta de métrica incluye un objeto `data_availability` : ```json { "data_availability": { "earliest_data_date": "2025-10-15", "latest_data_date": "2026-02-18", "requested_period_has_data": true } } ``` Comprueba `requested_period_has_data` antes de procesar los resultados. *** ## Proveedores de IA compatibles Usa estos valores en el `providers` filtro: | Valor | Plataforma | | -------------------- | ----------------------- | | `chat_gpt` | ChatGPT | | `gemini` | Google Gemini | | `perplexity` | Perplexity | | `google_ai_mode` | Modo IA de Google | | `google_ai_overview` | Resumen de IA de Google | | `claude` | Claude | Claude está disponible por defecto en los espacios de trabajo Enterprise. Cada respuesta de Claude usa cuatro unidades de facturación: cuatro tareas en un espacio de trabajo de tareas combinadas o cuatro créditos de respuesta en un espacio de trabajo heredado. Consulta [uso y facturación de respuestas AEO](/docs/es/tu-espacio-de-trabajo/settings/billing.md#aeo-answers-usage-and-billing). *** ## Países compatibles AirOps acepta estos 49 códigos de región. Pasa códigos ISO 3166-1 alfa-2 en el `countries` filtro: `AE` `AR` `AT` `AU` `BE` `BR` `CA` `CH` `CL` `CN` `CO` `CZ` `DE` `DK` `ES` `FI` `FR` `GB` `GR` `HR` `HU` `ID` `IE` `IL` `IN` `IS` `IT` `JP` `KE` `KR` `MX` `MY` `NG` `NL` `NO` `NZ` `PE` `PH` `PL` `PT` `SA` `SE` `SG` `TH` `TR` `TW` `US` `VN` `ZA` La cobertura de la plataforma varía según la región. Que una región aparezca en esta lista no garantiza que todos los proveedores de IA recopilen respuestas allí. Por ejemplo, Kenia es compatible con ChatGPT, Resumen de IA de Google, Modo IA de Google y Claude; otros proveedores pueden no estar disponibles. *** ## Errores | Estado | Significado | | ------- | --------------------------------------------------------------------------------------------------------------------------------------- | | **400** | Filtro, operador o campo de ordenación no válido. Comprueba `validation_errors` en la respuesta. | | **401** | Clave de API faltante o no válida. | | **402** | El endpoint requiere un espacio de trabajo de pago; las solicitudes de Web Pages desde espacios de trabajo Free devuelven este estado. | | **404** | Brand Kit no existe o no tienes acceso. | | **412** | AEO no está configurado para este Brand Kit. | | **422** | Específico de Analytics: `end_date` es hoy o posterior, el rango de fechas supera el límite de granularidad o hay más de 3 dimensiones. | *** ## Casos de uso ### ETL y exportación de datos AEO es una nueva categoría de datos que la mayoría de los stacks de marketing aún no tienen. La API te permite cargarla en tu data warehouse junto con los datos de SEO, pago y analítica web para análisis entre canales. **Qué exportar:** | Tabla | Endpoint de origen | Estrategia de sincronización | | ----------------------- | ----------------------------------------- | ----------------------------------------------- | | Métricas de visibilidad | Analytics (dimensiones: date, provider) | Incremental diario — añade la fila de ayer | | Tendencias competitivas | Analytics (dimensiones: date, competitor) | Incremental semanal | | Rendimiento de página | Páginas web | Instantánea diaria — recorre todas las páginas | | Inventario de citas | Citas | Instantánea semanal — recorre todas las citas | | Panorama de prompts | Prompts | Instantánea semanal — recorre todos los prompts | **Opciones de integración:** * **Airflow / Dagster / Prefect** — Añade un DAG que llame a la API, escriba JSON en S3/GCS y cargue mediante `COPY INTO` * **Airbyte / Fivetran** — Usa el conector genérico de origen HTTP API con método POST y paginación basada en desplazamiento * **Snowflake Snowpark** — Llama a la API directamente desde un procedimiento almacenado y programa con tareas de Snowflake * **AWS Lambda + Snowpipe** — Una función sin servidor en cron escribe en S3; Snowpipe ingiere automáticamente **Consejos de pipeline:** * `end_date` debe ser una fecha pasada — la API solo sirve datos finalizados, así que configúrala para ayer o antes. Las solicitudes con la fecha de hoy o una fecha futura devolverán un `422` error. * Las métricas de GSC y GA4 tienen un **retraso de 4 días** — es posible que aún no haya datos de los 3 días más recientes * Usar `per_page=100` (el máximo) para minimizar los viajes de ida y vuelta al paginar * Comprueba `meta.data_availability.requested_period_has_data` para detectar rangos de fechas vacíos antes de procesar * El endpoint de analytics tiene un límite de **1.000 filas** por consulta — para rangos de tiempo largos con dimensiones de alta cardinalidad, divídelos en ventanas según el límite de granularidad (120 días diario, 180 semanal, 365 mensual) El endpoint Web Pages es especialmente valioso para ETL porque combina AEO + GSC + GA4 en una sola respuesta — ahorrándote unir tres fuentes de datos separadas. ### Looker Studio Proporcionamos un Community Connector de Looker Studio listo para desplegar que visualiza tus datos de AEO directamente — sin necesidad de ETL, data warehouse ni programación. **Qué obtienes:** Tres fuentes de datos en un solo conector: | Fuente de datos | Lo que muestra | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | **Analítica de visibilidad de IA** | Tasa de menciones, cuota de voz, tasa de citas, sentimiento y más — segmentado por fecha, proveedor, competidor, tema o país | | **Rendimiento de página** | Métricas de AEO + Google Search Console + GA4 preunidas por URL en una sola fuente de datos | | **Citas** | URLs de origen citadas con información de dominio, sentimiento, puntuación de influencia y autoridad de dominio | #### Obtener tu clave de API 1. Inicia sesión en [AirOps](https://app.airops.com) y ve a **Configuración del espacio de trabajo** 2. Busca la **Clave de API** sección 3. Copia tu clave de API — o haz clic en **Regenerar** si necesitas una nueva La clave se autentica como un token Bearer. Mantenla confidencial y nunca la expongas en código del lado del cliente. > **Nota:** Regenerar tu clave de API invalida inmediatamente la anterior. Si tienes integraciones existentes que usan la clave, actualízalas antes de regenerarla. #### Conectarse a Looker Studio 1. Abre el [AirOps AEO Connector](https://lookerstudio.google.com/datasources/create?connectorId=AKfycbwR2EmDc6nXQkCLQNnn8EvUk_Z30Maf8wWD1sK3T13Zoe9LeeEQy3MtK6uzi_sU_1za) 2. **Autorizar** el conector cuando Google te lo solicite. Es posible que veas una advertencia de "Google no ha verificado esta app" — haz clic en **Avanzado** → **Ir a AirOps AEO Connector** para continuar. Esto solo aparece una vez. 3. Introduce tu **clave de API de AirOps** cuando se te pida 4. Completa la configuración: * **ID de Brand Kit** — tu ID numérico de Brand Kit (visible en la URL del panel de AirOps, por ejemplo, `app.airops.com/brand_kits/12345`) * **Fuente de datos** — elige una de las tres opciones: Analítica de visibilidad de IA, Rendimiento de página o Citas 5. Haz clic en **Conectar** — Looker Studio obtiene el esquema automáticamente 6. Haz clic en **Crear informe** para empezar a construir > **Consejo:** Añade el conector **tres veces** (una por fuente de datos) para tener analytics, rendimiento de página y citas todo en un solo informe. Cada fuente de datos se convierte en una fuente independiente que puedes usar en cualquier gráfico. #### Gráficos de ejemplo * **Serie temporal** — Tasa de menciones a lo largo del tiempo (Analytics: Date + Mention Rate) * **Gráfico de barras** — Cuota de voz por proveedor de IA (Analytics: AI Provider + Share of Voice) * **Comparación de competidores** — Barra agrupada de tasa de menciones por competidor * **Tabla de páginas principales** — URL con Citas, clics de GSC y tráfico de GA4 lado a lado (Pages) * **Diagrama de dispersión** — Citas vs. clics de GSC para encontrar páginas que ganan tanto en AEO como en SEO (Pages) * **Principales dominios que citan** — Gráfico de barras de Dominio por Citas (Citations) * **Desglose de sentimiento** — Gráfico circular del sentimiento de marca por recuento de citas (Citations) #### Campos disponibles **Analítica de visibilidad de IA:** | Dimensiones | Métricas | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | Fecha, Proveedor de IA, Competidor, Tema, País | Tasa de menciones, cuota de voz, tasa de citas, citas, sentimiento, posición media, primera tasa de menciones, respuestas | **Rendimiento de página:** | Dimensiones | Métricas | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | | URL, carpeta | Citas, tasa de citas, prompts, clics de GSC, impresiones de GSC, CTR de GSC, posición de GSC, tráfico de GA4, sesiones de GA4, engagement de GA4 | **Citas:** | Dimensiones | Métricas | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | | URL, dominio, categoría de dominio, tipo de página, marca mencionada, sentimiento de marca | Citas, cuota de citas, tasa de citas, puntuación de influencia, autoridad de dominio | #### Sugerencia de diseño del panel Una vista general ejecutiva de una sola página podría incluir: * **Fila superior** — Widgets de tarjeta de puntuación para Tasa de menciones, Cuota de voz, Tasa de citas, Citas totales * **Centro izquierdo** — Tasa de menciones a lo largo del tiempo (gráfico de líneas) * **Centro derecho** — Cuota de voz por proveedor de IA (gráfico de barras) * **Abajo a la izquierda** — Tabla de páginas principales (URL, Citas, clics de GSC, tráfico de GA4) * **Abajo a la derecha** — Principales dominios que citan (gráfico de barras) Añade una **Control de rango de fechas** widget al informe — las tres fuentes de datos lo respetan automáticamente. Se excluyen los datos de hoy porque están incompletos. #### Limitaciones * La API de Analytics permite un máximo de **3 dimensiones** por consulta * Page Performance y Citations devuelven las **500 primeras filas** por carga * Este es un Community Connector — cada usuario debe autorizarlo en el primer uso ### Paneles personalizados Crea paneles internos en Retool, Metabase o Grafana. El endpoint de analytics es lo bastante flexible para alimentar un panel completo desde un único endpoint — solo cambia las dimensiones. ### Informes automatizados Programa un script para extraer métricas semanales y enviar un resumen de Slack o un digest por correo a tu equipo. El endpoint de analytics con `competidor` y `date` dimensiones te da un informe competitivo completo en una sola llamada. ### Alertas Usa filtros inteligentes en un horario para detectar cuándo las páginas empiezan a perder visibilidad en IA o a caer en posicionamiento. Activa alertas en Slack, PagerDuty o correo cuando el `losing_ai_visibility` filtro devuelva resultados. ### Priorización de contenido Combina `citation_rate`, `puntuación de influencia`, y filtros inteligentes para clasificar programáticamente qué páginas optimizar primero. Alimenta la lista priorizada en tu calendario de contenido o herramienta de gestión de proyectos. *** Para ver las especificaciones completas de los endpoints, incluidos los esquemas de solicitud/respuesta, consulta la [Referencia de la API](https://docs.airops.com/api-reference/api-reference/brand-kits). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/es/desarrolladores/api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.