KI-Antworten
API + MCPAnfragen 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
Eine Liste der zurückzugebenden Felder.
Der Filterausdruck. Folgende Spaltenkennungen werden unterstützt (diese unterscheiden sich von den Kennungen, die vom Parameter select erkannt werden).
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#/...
Eine Liste von Markennamen und Websites, nach denen gesucht werden soll.
names or url_groups is requiredDie Namen der Marke/des Mitbewerbers
Die Domain des Ziels
Geltungsbereich des Ziels.
Eine Liste von Wettbewerbernamen und Websites, nach denen gesucht werden soll.
names or url_groups is requiredDie Namen der Marke/des Mitbewerbers
Die Domain des Ziels
Geltungsbereich des Ziels.
Optional phrases used to include or exclude results based on their content.
Only show results containing at least one of these exact phrases.
Hide results containing any of these exact phrases.
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.
Eine Liste zweistelliger Ländercodes (ISO 3166-1 alpha-2).
Der Typ der zu verwendenden Prompts. Wenn nicht angegeben, werden beide verwendet. Eigene Prompts erfordern die Angabe einer report_id.
Die Anzahl der zurückzugebenden Ergebnisse.
Das Datum, nach dem gesucht werden soll, im Format JJJJ-MM-TT.
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.
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.
Eine Spalte, nach der die Ergebnisse sortiert werden sollen.
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.
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).
Der zu filternde Volumenbereich.
Erfordert date_compared. Behält nur die Prompts, die sich auf eine der hier ausgewählten Arten geändert haben. Die drei Spalten werden per ODER verknüpft, ebenso die Werte innerhalb jeder Spalte. Daher trägt eine ausgelassene oder leere Spalte nichts zum Filter bei, und ein vollständig leeres Objekt behält jeden Prompt.
Prompts beibehalten, die nur an einem der beiden Daten beantwortet wurden (new, lost) oder an beiden (no_change).
Prompts beibehalten, bei denen die Menge Ihrer eigenen Marken, die in der Antwort erwähnt werden, eine Marke hinzugewonnen hat (new), eine verloren hat (lost) oder an beiden Daten identisch ist (no_change). Wettbewerber werden nicht berücksichtigt.
Prompts beibehalten, bei denen die Menge Ihrer eigenen Domains, die in der Antwort zitiert werden, eine Domain hinzugewonnen hat (new), eine verloren hat (lost) oder an beiden Daten identisch ist (no_change). Wettbewerber werden nicht berücksichtigt.
Das Ausgabeformat.
Antworten
Das Land der Frage.
Das Chatbot-Modell, das die Antwort generiert hat.
Das Datum, an dem die Daten zuletzt aktualisiert wurden.
(10 Einheiten) Die für die Antwort verwendeten Links.
Die vom Nutzer gestellte Frage.
(10 Einheiten) Die Antwort des Modells.
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.
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.
Der Anfrage zugewiesene Tags.
(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.