Panoramica - Menzioni
API + MCPLe richieste inviate a questo endpoint consumano unità API in base al parametro
prompts: le richieste che restituiscono solo dati di prompt personalizzati sono gratuite, mentre quelle che includono dati dei prompt di Ahrefs seguono la tariffazione standard delle unità API.
Ogni entità fornita in brands (e in competitors, se applicabile) deve includere almeno un valore in names. Le entità costituite solo da url_groups non sono supportate qui perché le menzioni vengono abbinate ai nomi dei brand.
Corpo della richiesta
L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).
Un elenco di campi da restituire.
Un'espressione di filtro per i tag dei prompt. Richiede report_id. Utilizza la sintassi dei filtri con le seguenti restrizioni: l'unico nome di campo valido è "tag"; gli unici operatori validi sono: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; la profondità massima di annidamento di and e or è 2. Esempio: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.
Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2).
L'ID del report da usare. Se ne viene indicato uno, gli altri parametri vengono presi dal report (brand, concorrenti, mercato, paese, filtri). Se vengono forniti il paese o i filtri, sovrascrivono quelli del report. Puoi trovarlo nell'URL del report di Brand Radar in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
Il tipo di prompt da usare. Se non specificato, verranno usati entrambi. I prompt personalizzati richiedono che venga fornito un report_id.
Un elenco di modelli di chatbot. I modelli di keyword di Google (google_ai_overviews_keywords, google_ai_mode_keywords) non possono essere combinati tra loro né con altri modelli.
Un elenco dei mercati di nicchia dei tuoi brand. Deprecato il 2026-05-18, questo parametro non avrà alcun effetto poco dopo questa data.
Un elenco di nomi e siti web dei concorrenti da cercare.
names or url_groups is requiredI nomi del brand/concorrente
Il dominio del target
Ambito del target.
Un elenco di nomi e siti web dei brand da cercare.
names or url_groups is requiredI nomi del brand/concorrente
Il dominio del target
Ambito del target.
Il formato di output.
Risposte
Nome del brand (il tuo brand o un concorrente fornito nella richiesta).
Menzioni stimate provenienti da risposte relative al mercato specificato che non menzionano alcun brand fornito (il valore è zero quando market non è specificato).
Menzioni stimate provenienti da risposte che menzionano solo i brand dei concorrenti.
Menzioni stimate provenienti da risposte che menzionano solo il tuo brand.
Menzioni stimate provenienti da risposte che menzionano sia il tuo brand sia i brand dei concorrenti.
Totale menzioni stimate per il tuo brand (include sia only_target_brand sia target_and_competitors_brands).