Quellen & Zitierungsanalyse
Jede URL, die die Modelle zitiert haben, dazu gruppierte Ansichten nach URL, Domain und Host, Metadaten aus dem Seiten-Cache, Belege für Erwähnungen auf den zitierten Seiten, Listen der Vorkommen und bereinigte zwischengespeicherte Inhalte.
Zitierte URLs behalten ihre Zitierungskennzahlen, auch wenn der Seiteninhalt nicht verfügbar ist. Sind die Erwähnungen einer Seite unbekannt, wird jetzt null zurückgegeben; Zu den möglichen Werten von content_gap_status gehört content_unavailable. Leere Crawl-Ergebnisse erscheinen nicht mehr als analysierte Seiten. Beobachtete Statuscodes 404 und 410 bleiben sichtbar.
GET/dimensions/sources
Listet die nicht abgelehnten Quellen aus Prompt-Ausführungen auf.
project_iderforderlichmodelcollection_idpromptPrompt-IDcountry_codelanguage_codeprompt_typebrand_kindrangefromtopageper_pagesource_typeowned|competitor|third_partymention_filtercompetitors
Bei jedem anderen Wert für source_type, auch bei abweichender Groß- und Kleinschreibung, antwortet die API mit ERR_INVALID_PARAM. Hier bezieht sich mention_filter auf die Marken, die im gecrawlten Inhalt der jeweils zitierten Seite genannt werden, nicht in der KI-Antwort, wie auf der Seite „Zitierungen“.
GET/citation_intelligence/groups
Zitierungsanalyse gruppiert nach url, domain oder host, mit Aufschlüsselung nach Modell, Zitierungsrate und durchschnittlicher Zitierungsposition (Zeilen mit position = 0 werden ignoriert).
project_iderforderlichviewurl|domain|hostpageper_pageordergroup_key,total_responses,total_citations,citation_rate,avg_citation_position,first_seen_at,last_seen_atdirectionmodelcollection_idcountry_codelanguage_codepromptfromtoquerysource_typeowned|competitor|third_party|social_media|own_domain|ugc|backgroundsentimentnegativecontent_gapmentioned|gap
Bei ungültigen Enum-Werten antwortet die API mit ERR_INVALID_PARAM.
brand_kind (brand|brand_other|non_brand) berücksichtigt nur die Antworten auf Prompts mit diesem Markenbezug. key liefert nur diese eine Gruppe der gewählten Ansicht: eine Domain, einen Host oder eine zitierte URL, so wie sie in der Liste steht. Domains und Hosts werden unabhängig von Groß- und Kleinschreibung und ohne www. abgeglichen; ergibt ein Wert keinen Treffer, liefert die API eine leere Liste statt eines Fehlers. Mit view=url ist der Wert eine einzelne, nicht normalisierte zitierte URL, deshalb bleiben ihre Varianten getrennte Zeilen; GET /citation_intelligence/urls/:url_sha256 führt sie zusammen, wie es auch die App tut. Mit einem key ergänzt include_series=true die Zeile um citation_series, im selben Format, das GET /citation_intelligence/urls/:url_sha256 liefert; dabei zählt jede Antwort einmal, gleich wie viele Seiten der Gruppe sie zitiert. Wird include_series ohne key übergeben, antwortet die API mit ERR_INVALID_PARAM.
GET/citation_intelligence/mentions_by_domain
Für die Antworten, in denen die jeweils angegebene Domain als Quelle zitiert wird, liefert der Endpunkt den Anteil dieser Antworten, die Ihre Marke erwähnen, im Vergleich zu jedem Wettbewerber. Marke und Wettbewerber werden so normalisiert, dass sie pro Domain zusammen 100 % ergeben, analog zur Definition von Erwähnungen im Share of Voice. Übergeben Sie mehrere Domains, um die gesamte Matrix mit einem Aufruf zu analysieren.
project_iderforderlichdomainserforderlich: eine Domain oder eine kommagetrennte Liste, z. B.domains=example.com,another.com;domains[]=funktioniert ebenfalls; maximal 50modelcollection_idcollection_idscountry_codelanguage_codepromptbrand_kindbrand|brand_other|non_brandfromto
Ist domains leer, wird ERR_INVALID_PARAM zurückgegeben. Jede Zeile enthält responses_citing, total_mentions und ein Array actors (Marke und Wettbewerber mit mentions und share).
GET/citation_intelligence/urls/:url_sha256
Details auf URL-Ebene für eine zitierte Seite: Summen, Zitierungsrate, durchschnittliche Zitierungsposition, Anzahl nach Quellentyp, Anzahl pro Modell, verschiedene URL-Varianten, Metadaten des Seiten-Caches sowie Nachweise für Erwähnungen auf der Seite mit Textauszügen und Bezeichnungen der Akteure.
- Parameter:
project_id(erforderlich),:url_sha256(64 Hexadezimalzeichen in der URL), dieselben optionalen Filter wie/citation_intelligence/groups.ERR_NOT_FOUNDwird nur zurückgegeben, wenn die URL in diesem Projekt nie zitiert wurde. Bleibt nach dem Filtern kein Ergebnis übrig, antwortet die API trotzdem mit200und liefert alle Statistiken mit dem Wert 0.
include_series=true ergänzt citation_series, also die Antworten, die unter denselben Filtern die URL zitieren (key gilt hier nicht): total (gleich stats.total_responses), by_model (Antworten pro KI-Modell, absteigend sortiert; kann auch aktivierte Modelle außerhalb der sieben enthalten, die model akzeptiert) und data mit einem Punkt { date, value } pro Zeitraum von granularity. Der Zeitraum ist day, week oder month, je nach Tracking-Rhythmus des Kontos; ein Konto mit täglichem Tracking erhält Wochen, die am Montag beginnen, wenn die gefilterten Antworten mehr als 60 Tage umfassen. Jede Antwort wird nach ihrem executed_at in der Zeitzone Europe/Madrid datiert; nach dieser Spalte filtern auch from und to. Ein Zeitraum mit Antworten, die die URL nicht zitiert haben, zeigt 0. Ohne include_series bleibt die API-Antwort unverändert.
GET/citation_intelligence/urls/:url_sha256/occurrences
Paginierte Vorkommen einer zitierten URL in allen Prompt-Ausführungen, pro Zeile mit Auszug aus der Antwort, Prompt-Text, Modell, executed_at, citation_position und source_type.
- Parameter:
project_id(erforderlich),:url_sha256(64 Hexadezimalzeichen),page,per_pagesowie dieselben optionalen Filter wie/citation_intelligence/groups.
GET/citation_intelligence/urls/:url_sha256/content
Bereinigter Seiteninhalt im Cache für eine zitierte URL: Metadaten des Seiten-Caches, Nachweise und Textauszüge zu Erwähnungen, vollständiger unformatierter Text und gerendertes HTML (Skripte und unsicheres Markup entfernt).
project_iderforderlich:url_sha25664 Hexadezimalzeichen