Übersicht – 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

wherestring

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

selectstringErforderlich

Eine durch Kommas getrennte Liste der zurückzugebenden Felder.

countrystring

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

Zulässige Werte:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

Die ID des zu verwendenden Reports. Wenn eine angegeben ist, werden andere Parameter aus dem Report übernommen (Marke, Wettbewerber, Markt, Land, Filter). Wenn Land oder Filter angegeben werden, haben sie Vorrang vor den Angaben im Report. Du findest sie in der URL deines Brand-Radar-Reports in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Der Typ der zu verwendenden Prompts. Wenn nicht angegeben, werden beide verwendet. Eigene Prompts erfordern, dass eine report_id angegeben wird.

Zulässige Werte:ahrefscustom

data_sourcestringErforderlich

Eine durch Kommas getrennte Liste von Chatbot-Modellen. Google-Keyword-Modelle (google_ai_overviews_keywords, google_ai_mode_keywords) können weder miteinander noch mit anderen Modellen kombiniert werden.

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

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

competitorsstring

Eine durch Kommas getrennte Liste von Wettbewerbern deiner Marken.

brandstring

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

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).