Impressionen

API + MCP

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

Anfrage-Body

selectarray<string>Required

Eine Liste der zurückzugebenden Felder.

Example:["field_a","field_b"]

whereobject

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

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>

Die Namen der Marke/des Mitbewerbers

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

Die Domain des Ziels

Example:ahrefs.com

scopestringrequired

Geltungsbereich des Ziels.

Zulässige Werte:urlpathdomainsubdomains

competitorsarray<object>

Eine Liste von Wettbewerbernamen und Websites, nach denen gesucht werden soll.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Die Namen der Marke/des Mitbewerbers

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

Die Domain des Ziels

Example:ahrefs.com

scopestringrequired

Geltungsbereich des Ziels.

Zulässige Werte:urlpathdomainsubdomains

content_filterobject

Optionale Phrasen, mit denen Ergebnisse anhand ihres Inhalts ein- oder ausgeschlossen werden können.

includearray<string>

Zeigt nur Ergebnisse an, die mindestens eine dieser exakten Phrasen enthalten.

excludearray<string>

Blendet Ergebnisse aus, die eine dieser exakten Phrasen enthalten.

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. Wenn nicht angegeben, werden beide verwendet. Eigene Prompts erfordern die Angabe einer report_id.

Zulässige Werte:ahrefscustom

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>

brandstring

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

entity_typestring

Gibt an, ob die Zeile ein Aggregat, Ihre Zielmarke oder einen Mitbewerber darstellt.

Zulässige Werte:aggregatetargetcompetitor

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