KI-Antworten

API + MCP

POST/v3/brand-radar/ai-responses

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

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

selectarray<string>Required

Eine Liste der zurückzugebenden Felder.

Example:["field_a","field_b"]

whereobject

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

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

limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Default:1000

datestring (date)

Das zu durchsuchende Datum im Format YYYY-MM-DD.

search_volume_typestring

Reports zur KI-Sichtbarkeit stellen auf KI-angepasstes Suchvolumen um. Damit lässt sich die Nachfrage nach KI-Antworten über Chatbots und KI-Suchoberflächen hinweg besser abschätzen. Es wird berechnet, indem das Google-Suchvolumen anhand der geschätzten Nutzung jeder KI-Plattform im Vergleich zu Google angepasst wird. Dieser Parameter wird ab dem 31. August 2026 nicht mehr unterstützt; alle Anfragen verwenden dann das neue KI-angepasste Suchvolumen.

Zulässige Werte:ask_volumekeyword_volume

Default:ask_volume

countryarray<string>

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

Zulässige Werte:adaeafagaialamaoarasatauawazba…

Default:[]

order_bystring

Eine Spalte, nach der die Ergebnisse sortiert werden.

Zulässige Werte:relevancevolume

Default:relevance

report_idstring

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

promptsstring

Die Art der zu verwendenden Prompts. Wenn nichts angegeben ist, werden beide verwendet. Für eigene Prompts muss report_id angegeben sein.

Zulässige Werte:ahrefscustom

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

marketarray<string>

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

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 Wettbewerbers

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

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 Wettbewerbers

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

outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphp

Antworten

ai_responsesarray<object>

countrystring

Das Land der Frage.

data_sourcestring

Das Chatbot-Modell, das die Antwort generiert hat.

last_updatedstring (date)

Das Datum, an dem die Daten zuletzt aktualisiert wurden.

linksarray<object>

(10 Einheiten) Die für die Antwort verwendeten Links.

urlstring

titlestring or null

questionstring

Die vom Nutzer gestellte Frage.

responsestring

(10 Einheiten) Die Antwort des Modells.

search_queriesarray<string>

Die vom Chatbot verwendete Suchanfrage, um Informationen für die Antwort zu finden. Hinweis: Wenn data_source weder chatgpt noch perplexity enthält, ist dieses Feld immer leer.

tagsarray<string>

Der Anfrage zugewiesene Tags.

volumeinteger

(10 Einheiten) Geschätzte monatliche Suchanfragen. Dies basiert auf unseren Schätzungen für Google und kombiniert die Suchvolumina verwandter Keywords, in deren „Weitere Fragen"-Bereich diese Frage erscheint.

curl "https://api.ahrefs.com/v3/brand-radar/ai-responses" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "brand_filter": {"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}, "volume_range": { "from": 0, "to": 0 }, "select": ["field_a","field_b"], "where": {}, "tags_filter": {"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}, "limit": 0, "date": "string", "search_volume_type": "ask_volume", "country": ["ad"], "order_by": "relevance", "report_id": "string", "prompts": "ahrefs", "data_source": ["chatgpt"], "market": ["string"], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "brands": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "output": "json" }'

{ "ai_responses": [ { "country": "string", "data_source": "string", "last_updated": "string", "links": [ { "url": "string", "title": "string" } ], "question": "string", "response": "string", "search_queries": ["string"], "tags": ["string"], "volume": 0 } ] }