Docs
Dokumentation durchsuchen...⌘K

Übersichtsverlauf – Zitationen

Nur API
POST/v3/brand-radar/citations-history

Anfragen an diesen Endpunkt verbrauchen API-Einheiten basierend auf dem Parameter prompts: Anfragen, die nur Daten zu eigenen Prompts zurückgeben, sind kostenlos, während Anfragen mit Ahrefs-Prompt-Daten nach der Standardpreisgestaltung für API-Einheiten berechnet werden.

Jede in brands (und gegebenenfalls competitors) angegebene Entität muss mindestens einen Wert in url_groups enthalten. Entitäten, die nur aus names bestehen, werden hier nicht unterstützt, da Zitationen anhand von URL-Gruppen abgeglichen werden.

Anfrage-Body

whereobject

Der Filterausdruck. Die folgenden Spaltenbezeichner werden erkannt (sie unterscheiden sich von den Bezeichnern, die vom Parameter select erkannt werden).

tags_filterobject

Ein Filterausdruck für Prompt-Tags. Erfordert report_id. Verwendet die Filter-Syntax mit folgenden Einschränkungen: Der einzige gültige Feldname ist "tag"; die einzigen gültigen Operatoren sind "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; die maximale Verschachtelungstiefe für and und or beträgt 2.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}
date_tostring (date)

Das Enddatum des historischen Zeitraums im Format YYYY-MM-DD.

date_fromstring (date)Required

Das Startdatum des historischen Zeitraums im Format YYYY-MM-DD.

search_volume_typestring

Reports zur KI-Sichtbarkeit stellen auf KI-angepasstes Suchvolumen um. Damit lässt sich die Nachfrage nach KI-Antworten über Chatbots und KI-Suchoberflächen hinweg besser abschätzen. Es wird berechnet, indem das Google-Suchvolumen anhand der geschätzten Nutzung jeder KI-Plattform im Vergleich zu Google angepasst wird. Dieser Parameter wird ab dem 31. August 2026 nicht mehr unterstützt; alle Anfragen verwenden dann das neue KI-angepasste Suchvolumen.

Zulässige Werte:ask_volumekeyword_volume
Default:ask_volume
countryarray<string>

Eine Liste zweistelliger Ländercodes (ISO 3166-1 alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazba…
Default:[]
report_idstring

Die ID des zu verwendenden Reports. Wenn sie angegeben ist, werden andere Parameter aus dem Report übernommen (market, country, filters). Wenn country oder filters angegeben sind, überschreiben sie die entsprechenden Werte im Report. Sie finden die ID in der URL Ihres Brand Radar-Reports in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Die Art der zu verwendenden Prompts. Wenn nichts angegeben ist, werden beide verwendet. Für eigene Prompts muss report_id angegeben sein.

Zulässige Werte:ahrefscustom
data_sourcearray<string>Required

Eine Liste von Chatbot-Modellen. Alle Modelle können miteinander kombiniert werden. Das claude-Modul unterstützt ausschließlich eigene Prompts.

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

Eine Liste der Nischenmärkte Ihrer Marken. Veraltet ab dem 2026-05-18; dieser Parameter wird kurz nach diesem Datum keine Wirkung mehr haben.

brandsarray<object>

Eine Liste von Markennamen und Websites, nach denen gesucht werden soll.

Default:[]
At least one of names or url_groups is required
namesarray<string>

Die Namen der Marke/des Wettbewerbers

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Die Domain des Ziels

Example:ahrefs.com
scopestringrequired

Geltungsbereich des Ziels.

Zulässige Werte:urlpathdomainsubdomains
outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

metricsarray<object>
citationsinteger

Geschätzte Anzahl von Zitationen in Antworten, die die Marken-URLs erwähnen.

datestring (date)