Docs
Dokumentation durchsuchen...⌘K

Zitierte Domains

API + MCP
POST/v3/brand-radar/cited-domains

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

volume_rangeobject

Der zu filternde Volumenbereich.

frominteger
tointeger
selectarray<string>Required

Eine Liste der zurückzugebenden Felder.

Verfügbare Felder:
  • domain
  • pages
  • responses
Example:["field_a","field_b"]
whereobject

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

tags_filterobject

Ein Filterausdruck für Prompt-Tags. Erfordert report_id. Verwendet die Filtersyntax 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 von and und or beträgt 2. Beispiel: {"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.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

Eine 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.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_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.

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.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

Eine Liste von Markennamen und Websites, nach denen gesucht werden soll.

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.

Allowed values:urlpathdomainsubdomains
outputstring

Das Ausgabeformat.

Allowed values:jsonphp

Antworten

domainsarray<object>
domainstring

Der zitierte Domainname.

mentionsarray<object>

Veraltet am 2026-02-10.

pagesinteger

Die Anzahl eindeutiger Seiten der Domain, die in den Antworten zitiert wurden.

responsesinteger

Die Anzahl der Antworten, die die Domain zitiert haben.

volumeinteger

Veraltet am 2026-03-24.