Fuentes e inteligencia de citaciones

Todas las URL que citaron los modelos, además de vistas agrupadas por URL, dominio y host, metadatos de caché de página, evidencia de menciones dentro de las páginas citadas, listas de apariciones y contenido en caché saneado.

GET/dimensions/sources

Enumera las fuentes no rechazadas generadas por las ejecuciones de prompt.

Parámetros:
  • project_idobligatorio
  • model
  • collection_id
  • promptID de prompt
  • country_code
  • language_code
  • from
  • to
  • page
  • per_page
  • source_type
  • mention_filter
  • competitors

Aquí, mention_filter se aplica a las marcas que aparecen en el contenido rastreado de cada página citada, no en la respuesta de IA, igual que en la página de Citaciones.

GET/citation_intelligence/groups

Inteligencia de citaciones agrupada por url, domain o host con desglose por modelo, tasa de citaciones y posición media de la citación (ignora las filas con position = 0).

Parámetros:
  • project_idobligatorio
  • viewurl|domain|host
  • page
  • per_page
  • ordergroup_key, total_responses, total_citations, citation_rate, avg_citation_position, first_seen_at, last_seen_at
  • direction
  • model
  • collection_id
  • country_code
  • language_code
  • prompt
  • from
  • to
  • query
  • source_typeowned|competitor|third_party|social_media|own_domain|ugc|background
  • sentimentnegative
  • content_gapmentioned|gap

Los valores de enumeración no válidos devuelven ERR_INVALID_PARAM.

GET/citation_intelligence/mentions_by_domain

Para las respuestas en las que se cita cada dominio de origen indicado, la cuota de esas respuestas que mencionan tu marca frente a cada competidor. La marca y los competidores se normalizan para que sumen 100 % por dominio, siguiendo la definición de mención del Share of Voice. Pasa varios dominios para analizar la matriz completa en una sola llamada.

Parámetros:
  • project_idobligatorio
  • domainsarray obligatorio, p. ej. domains[]=example.com, máx. 50
  • model
  • collection_id
  • collection_ids
  • country_code
  • language_code
  • prompt
  • from
  • to

Un domains vacío devuelve ERR_INVALID_PARAM. Cada fila tiene responses_citing, total_mentions y un array actors (marca y competidores con mentions y share).

GET/citation_intelligence/urls/:url_sha256

Detalle a nivel de URL de una página citada: totales, tasa de citaciones, posición media de la citación, recuentos por tipo de fuente, recuentos por modelo, variantes de URL distintas, metadatos de la caché de página y evidencia de menciones en la página con fragmentos y etiquetas de actor.

  • Parámetros: project_id (obligatorio), :url_sha256 (64 caracteres hexadecimales en la URL), los mismos filtros opcionales que /citation_intelligence/groups. ERR_NOT_FOUND solo cuando el proyecto nunca ha citado la URL; los filtros que vacían el resultado siguen devolviendo 200 con estadísticas a cero.

GET/citation_intelligence/urls/:url_sha256/occurrences

Ocurrencias paginadas de una URL citada en las ejecuciones de prompt, con extracto de la respuesta, texto del prompt, modelo, executed_at, citation_position y source_type por fila.

  • Parámetros: project_id (obligatorio), :url_sha256 (64 caracteres hexadecimales), page, per_page y los mismos filtros opcionales que /citation_intelligence/groups.

GET/citation_intelligence/urls/:url_sha256/content

Contenido saneado de la página en caché para una URL citada: metadatos de la caché de página, evidencia de menciones y fragmentos, texto plano completo y HTML renderizado (se eliminan los scripts y el marcado no seguro).

Parámetros:
  • project_idobligatorio
  • :url_sha25664 caracteres hexadecimales