Impressionen

API + MCP

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

Query-Parameter

wherestring

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

report_idstring

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

brandstringErforderlich

Die Marke, nach der gesucht werden soll.

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

date_fromstring (date)Erforderlich

Das Startdatum des historischen Zeitraums im Format JJJJ-MM-TT.

date_tostring (date)

Das Enddatum des historischen Zeitraums im Format JJJJ-MM-TT.

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

metricsarray<object>

datestring (date)

impressionsinteger

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