Docs
Dokumentation durchsuchen...⌘K

Themen

API + MCPNur Enterprise
POST/v3/brand-radar/topics

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.

Verfügbare Felder:
  • country
  • mentions
  • responses
  • topic
  • volume
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
limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Default:1000
datestring (date)

Das Datum, nach dem gesucht werden soll, im Format JJJJ-MM-TT.

date_fromstring (date)

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

date_tostring (date)

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

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"]}]}
brand_filterobject

Ein Filterausdruck für die Sichtbarkeit Ihrer Marke, der den Filter „Ihre Marke“ abbildet. brand_name gibt an, ob eine Antwort Ihre Marke erwähnt: "mentioned" oder "not_mentioned". page_status gibt an, wie die KI Ihre Seiten verwendet hat: "cited" (die KI hat Seiten Ihrer Website abgerufen und in der Antwort darauf verwiesen), "found_but_not_cited" (die KI hat Seiten Ihrer Website als potenzielle Quellen abgerufen, in der endgültigen Antwort jedoch nicht darauf verwiesen) oder "not_found" (die KI hat keine Seiten Ihrer Website abgerufen).
Verwendet die Filter-Syntax mit folgenden Einschränkungen: Der einzige gültige Operator ist "eq"; jedes Feld bildet einen eigenen Abschnitt: Geben Sie einen einzelnen Wert an oder kombinieren Sie mehrere Werte desselben Felds mit or; verbinden Sie die Abschnitte brand_name und page_status mit einem and/or auf oberster Ebene. Die Auswahl aller Werte eines Felds wird abgelehnt, da sie alles erfassen würde (lassen Sie das Feld stattdessen weg).

Example:{"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}
volume_rangeobject

Der zu filternde Volumenbereich.

frominteger
tointeger
outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphp

Antworten

topicsarray<object>
countrystring

Das mit dem Thema verknüpfte Land. Wenn kein übergeordnetes Thema identifiziert wurde, ist dies das einzige ausgewählte Land oder all, wenn mehrere oder alle Länder ausgewählt wurden.

mentionsarray<object>

Anzahl der Antworten für die getrackte Marke und jeden Mitbewerber.

entitystring

Die getrackte Marke oder der Mitbewerber.

responsesinteger

Die Anzahl der KI-Antworten, die die Entität erwähnen.

responsesinteger

Die Anzahl der KI-Antworten, die mit dem Thema verknüpft sind.

topicstring or null

Das übergeordnete Thema. Null, wenn kein übergeordnetes Thema identifiziert wurde.

volumeinteger or null

Das geschätzte monatliche Suchvolumen des Themas.