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. Folgende Spaltenkennungen werden unterstützt (diese unterscheiden sich von den Kennungen, 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#/...

brandstring

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

competitorsstring

Eine durch Kommas getrennte Liste von Wettbewerbern Ihrer Marken.

data_sourcestringErforderlich

Eine kommagetrennte Liste von Chatbot-Modellen. Alle Modelle können miteinander kombiniert werden. Das Modul claude unterstützt nur eigene Prompts.
Die Modelle google_ai_overviews_keywords und google_ai_mode_keywords geben die aus Google-Suchanfragen (Keywords) statt aus Prompts abgeleitete Sichtbarkeit in AI Overviews / im KI-Modus aus.

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
countrystring

Eine durch Kommas getrennte Liste zweibuchstabiger Ländercodes (ISO 3166-1 alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazba…
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.

Standard:1000
datestring (date)

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

date_comparedstring (date)

Ein Datum zum Vergleich mit date, im Format JJJJ-MM-TT. Es muss strikt vor date liegen. Wenn gesetzt, umfasst der Report jeden Prompt, der an einem der beiden Datumswerte beantwortet wurde, und das Feld status gibt an, wie sich der jeweilige Prompt zwischen ihnen verändert hat. Ein Prompt, der nur an date_compared beantwortet wurde, wird als lost gemeldet, und die übrigen Felder beschreiben seine Antwort für date_compared, da es für date keine gibt.

search_volume_typestring

KI-Sichtbarkeits-Reports 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 für jede KI-Plattform anhand ihrer geschätzten Nutzung im Vergleich zu Google angepasst wird. Dieser Parameter gilt ab dem 30. September 2026 als veraltet; alle Anfragen verwenden dann das neue KI-angepasste Suchvolumen.

Zulässige Werte:ask_volumekeyword_volume
Standard:ask_volume
order_bystring

Eine Spalte, nach der die Ergebnisse sortiert werden sollen.

Zulässige Werte:relevancevolume
Standard:relevance
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.

statusstring or null

Wie sich der Prompt zwischen date_compared und date geändert hat. Null, sofern date_compared nicht gesetzt ist. new – am Datum date beantwortet, aber nicht am Datum date_compared. lost – am Datum date_compared beantwortet, aber nicht am Datum date; der Rest dieser Zeile beschreibt die Antwort zu date_compared, da es keine zu date gibt. no_change – an beiden Datumswerten beantwortet; das sagt nichts darüber aus, ob sich die Antwort selbst, ihre Erwähnungen oder ihre Zitate verändert haben.

Zulässige Werte:newlostno_change
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.