Impressionen

API + MCP

GET/v3/brand-radar/impressions-overview

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.

Query-Parameter

selectstringErforderlich

Eine kommagetrennte Liste der zurückzugebenden Felder.

wherestring

Der Filterausdruck. Folgende Spaltenkennungen werden unterstützt (diese unterscheiden sich von den Kennungen, die vom Parameter select erkannt werden).

report_idstring

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

brandstring

Eine durch Kommas getrennte Liste von Marken, nach denen gesucht werden soll. Mindestens einer der Parameter brand, competitors, market oder where darf nicht leer sein.

competitorsstring

Eine durch Kommas getrennte Liste von Wettbewerbern Ihrer Marken.

data_sourcestringErforderlich

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

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

Eine durch Kommas getrennte Liste zweibuchstabiger Ländercodes (ISO 3166-1 alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazba…

promptsstring

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

Zulässige Werte:ahrefscustom

search_volume_typestring

KI-Sichtbarkeits-Reports 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 für jede KI-Plattform anhand ihrer geschätzten Nutzung im Vergleich zu Google angepasst wird. Dieser Parameter gilt ab dem 30. September 2026 als veraltet; alle Anfragen verwenden dann das neue KI-angepasste Suchvolumen.

Zulässige Werte:ask_volumekeyword_volume

Standard:ask_volume

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

metricsarray<object>

brandstring

Markenname (entweder Ihre Marke oder ein in der Anfrage angegebener Wettbewerber).

no_tracked_brandsinteger

Geschätzte Impressionen aus Antworten, die sich auf den angegebenen Markt beziehen und keine der bereitgestellten Marken erwähnen (Wert ist 0, wenn market nicht angegeben ist).

only_competitors_brandsinteger

Geschätzte Impressionen aus Antworten, die ausschließlich Wettbewerber-Marken erwähnen.

only_target_brandinteger

Geschätzte Impressionen aus Antworten, die ausschließlich Ihre Marke erwähnen.

target_and_competitors_brandsinteger

Geschätzte Impressionen aus Antworten, die sowohl Ihre Marke als auch Wettbewerber-Marken erwähnen.

totalinteger

Gesamte geschätzte Impressionen für Ihre Marke (umfasst only_target_brand und target_and_competitors_brands).