Verlaufsübersicht – 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. Folgende Spaltenkennungen werden erkannt (dies unterscheidet sich von den Kennungen, die vom Parameter select erkannt werden).

cited_domain: Die Domain einer Seite, die zur Erstellung der Antwort verwendet wurde.
typ: domain

cited_domain_subdomains: Die Domain einer Seite, die zur Erstellung der Antwort verwendet wurde. Jede Subdomain der angegebenen Domain wird ebenfalls berücksichtigt.
typ: string

cited_url_exact: Die URL einer Seite, die zur Erstellung der Antwort verwendet wurde.
typ: string

cited_url_prefix: Die URL einer Seite, die zur Erstellung der Antwort verwendet wurde. Jede URL, die mit diesem Präfix beginnt, wird berücksichtigt.
typ: string

question: Die vom Benutzer gestellte Frage.
typ: string

response (10 Einheiten): Die Antwort des Modells.
typ: string

search_queries: Die Suchanfrage, die der Chatbot verwendet hat, um Informationen für die Antwort zu finden. Hinweis: Wenn data_source weder chatgpt noch perplexity enthält, ist dieses Feld immer leer.
typ: string

topic: Das Thema der Anfrage.
typ: string

date_tostring

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

date_fromstringErforderlich

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

countrystring

Eine kommagetrennte Liste zweibuchstabiger 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 (market, country, filters). Wenn country oder filters 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#/...

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-Modelle (google_ai_overviews, google_ai_mode) können weder miteinander noch mit Nicht-Google-Modellen kombiniert werden.

Zulässige Werte:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok

Example:chatgpt,perplexity

marketstring

Eine durch Kommas getrennte Liste der Nischenmärkte deiner Marken.

brandstringErforderlich

Die Brand, nach der gesucht werden soll.

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

metricsarray<object>

datestring

impressionsinteger

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