Sources et analyse des citations

Toutes les URL citées par les modèles, avec des vues groupées par URL, domaine et hôte, les métadonnées du cache des pages, les preuves de mention dans les pages citées, les listes d’occurrences et le contenu en cache assaini.

Les URL citées conservent leurs métriques de citation lorsque le contenu de la page n’est pas disponible. Une mention de page inconnue renvoie désormais null ; content_gap_status inclut content_unavailable. Les résultats de crawl vides n’apparaissent plus comme des pages analysées. Les statuts 404 et 410 observés restent visibles.

GET/dimensions/sources

Liste les sources non rejetées issues des exécutions de prompts.

Paramètres :
  • project_idobligatoire
  • model
  • collection_id
  • promptID du prompt
  • country_code
  • language_code
  • prompt_type
  • brand_kind
  • range
  • from
  • to
  • page
  • per_page
  • source_typeowned|competitor|third_party
  • mention_filter
  • competitors

Toute autre valeur de source_type, y compris avec une casse différente, renvoie ERR_INVALID_PARAM. Ici, mention_filter porte sur les marques mentionnées dans le contenu crawlé de chaque page citée, et non dans la réponse de l’IA, comme sur la page Citations.

GET/citation_intelligence/groups

Citations regroupées par url, domain ou host, avec ventilation par modèle, taux de citation et position moyenne de citation (les lignes avec position = 0 sont ignorées).

Paramètres :
  • project_idobligatoire
  • 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

Une valeur énumérée non valide renvoie ERR_INVALID_PARAM.

brand_kind (brand|brand_other|non_brand) ne garde que les réponses aux prompts de cette catégorie (marque dans le prompt). key renvoie uniquement ce groupe de la vue choisie : un domaine, un hôte ou une URL citée, tels qu’ils sont listés. Les domaines et les hôtes correspondent sans tenir compte de la casse ni du www. ; une clé sans correspondance renvoie une liste vide, pas une erreur. Avec view=url, la clé est une URL citée brute, si bien que ses variantes restent des lignes distinctes ; GET /citation_intelligence/urls/:url_sha256 les fusionne, comme le fait l’application. Avec une key, include_series=true ajoute citation_series à la ligne, au format que renvoie GET /citation_intelligence/urls/:url_sha256, en comptant chaque réponse une seule fois, quel que soit le nombre de pages du groupe qu’elle cite. include_series sans key renvoie ERR_INVALID_PARAM.

GET/citation_intelligence/mentions_by_domain

Pour les réponses où chaque domaine source indiqué est cité, part de ces réponses qui mentionnent votre marque et chaque concurrent. La marque et les concurrents sont normalisés pour totaliser 100 % par domaine, selon la définition des mentions retenue pour le Share of Voice. Indiquez plusieurs domaines pour analyser toute la matrice en un seul appel.

Paramètres :
  • project_idobligatoire
  • domainsobligatoire : un domaine ou une liste séparée par des virgules, par exemple domains=example.com,another.com ; domains[]= fonctionne aussi ; 50 maximum
  • model
  • collection_id
  • collection_ids
  • country_code
  • language_code
  • prompt
  • brand_kindbrand|brand_other|non_brand
  • from
  • to

Un domains vide renvoie ERR_INVALID_PARAM. Chaque ligne contient responses_citing, total_mentions et un tableau actors (la marque et les concurrents, avec mentions et share).

GET/citation_intelligence/urls/:url_sha256

Détail d’une page citée : totaux, taux de citation, position moyenne de citation, nombre par type de source, nombre par modèle, variantes distinctes de l’URL, métadonnées du cache de page et preuves de mention avec extraits et libellés d’acteurs.

  • Paramètres : project_id (obligatoire), :url_sha256 (64 caractères hexadécimaux dans l’URL), mêmes filtres facultatifs que /citation_intelligence/groups. ERR_NOT_FOUND uniquement si l’URL n’a jamais été citée par le projet ; les filtres qui vident le résultat renvoient tout de même 200 avec des statistiques à zéro.

include_series=true ajoute citation_series, les réponses qui citent l’URL avec les mêmes filtres (key ne s’applique pas ici) : total (égal à stats.total_responses), by_model (réponses par modèle d’IA, par ordre décroissant, avec parfois des modèles activés hors des sept valeurs qu’accepte model) et data, un point { date, value } par période de granularity. La période (day, week ou month) suit la fréquence de suivi du compte, et un compte quotidien reçoit des semaines, commençant le lundi, lorsque les réponses filtrées couvrent plus de 60 jours. Chaque réponse est datée du jour de sa création, fuseau Europe/Madrid, la date que filtrent from et to. Une période dont les réponses n’ont pas cité l’URL affiche 0. Sans include_series, la réponse est inchangée.

GET/citation_intelligence/urls/:url_sha256/occurrences

Occurrences paginées d’une URL citée dans les exécutions de prompts, avec pour chaque ligne un extrait de la réponse, le texte du prompt, le modèle, executed_at, citation_position et source_type.

  • Paramètres : project_id (obligatoire), :url_sha256 (64 caractères hexadécimaux), page, per_page, mêmes filtres facultatifs que /citation_intelligence/groups.

GET/citation_intelligence/urls/:url_sha256/content

Contenu nettoyé de la page en cache pour une URL citée : métadonnées du cache de page, preuves et extraits de mention, texte brut complet et HTML rendu (scripts et balisage dangereux supprimés).

Paramètres :
  • project_idobligatoire
  • :url_sha25664 caractères hexadécimaux