Docs
Dokumentation durchsuchen...⌘K

KI-Antworten

API + MCP
GET/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.

Query-Parameter

selectstringErforderlich

Eine durch Kommas getrennte Liste der zurückzugebenden Felder.

wherestring

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

limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Standard:1000
datestring (date)

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

countrystring

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

Zulässige Werte:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
order_bystring

Eine Spalte, nach der die Ergebnisse sortiert werden sollen.

Zulässige Werte:relevancevolume
Standard:relevance
report_idstring

Die ID des zu verwendenden Reports. Wenn eine angegeben ist, werden andere Parameter aus dem Report übernommen (Marke, Wettbewerber, Markt, Land, Filter). Wenn Land oder Filter angegeben werden, haben sie Vorrang vor den Angaben 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-Keyword-Modelle (google_ai_overviews_keywords, google_ai_mode_keywords) können weder miteinander noch mit anderen Modellen kombiniert werden.

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
marketstring

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

competitorsstring

Eine durch Kommas getrennte Liste von Wettbewerbern deiner Marken.

brandstring

Eine durch Kommas getrennte Liste von Marken, nach denen gesucht werden soll. Mindestens eines der Felder "brand", "competitors", "market" oder "where" darf nicht leer sein.

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.