Docs
Dokumentation durchsuchen...⌘K

Verlaufsübersicht – Impressionen

API + MCP
POST/v3/brand-radar/impressions-history

Anfragen an diesen Endpoint verbrauchen API-Einheiten basierend auf dem Parameter prompts: Anfragen, die ausschließlich Daten zu einem eigenen Prompt zurückgeben, sind kostenlos, während Anfragen mit Ahrefs-Prompt-Daten der Standard-Preisgestaltung für API-Einheiten folgen.

Anfrage-Body

whereobject

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

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#/...

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>

The names of the brand/competitor

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

The domain of the target

Example:ahrefs.com
scopestringrequired

Scope of the target.

Zulässige Werte:urlpathdomainsubdomains
data_sourcearray<string>Required

Eine Liste von Chatbot-Modellen. Alle Modelle können miteinander kombiniert werden. Das claude-Modul unterstützt nur eigene Prompts.
Die Modelle google_ai_overviews_keywords und google_ai_mode_keywords geben die Sichtbarkeit in AI Overviews / im AI Mode an, die aus Google-Suchanfragen (Keywords) statt aus Prompts abgeleitet wird.

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
countryarray<string>

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

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

Der Typ der zu verwendenden Prompts. Falls nicht angegeben, werden beide verwendet. Eigene Prompts erfordern die Angabe von report_id.

Zulässige Werte:ahrefscustom
date_fromstring (date)Required

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

date_tostring (date)

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

search_volume_typestring

KI-Sichtbarkeits-Reports wechseln zu KI-angepasstem Volumen. Es schätzt die Nachfrage nach KI-Antworten über Chatbots und KI-Suchflächen hinweg besser. Es wird berechnet, indem das Google-Suchvolumen anhand der geschätzten Nutzung jeder KI-Plattform im Vergleich zu Google angepasst wird. Dieser Parameter wird am 30. September 2026 eingestellt; alle Anfragen verwenden dann das neue KI-angepasste Volumen.

Zulässige Werte:ask_volumekeyword_volume
Default:ask_volume
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"]}]}
outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

metricsarray<object>
datestring (date)
impressionsinteger

Geschätzte Impressionen aus Antworten, die die Marke erwähnen.