Panoramica - Menzioni

API + MCP

POST/v3/brand-radar/mentions-overview

Le richieste a questo endpoint consumano unità API in base al parametro prompts: le richieste che restituiscono solo i dati dei prompt personalizzati sono gratuite, mentre le richieste che includono i dati dei prompt Ahrefs seguono il prezzo standard delle unità API.

Corpo della richiesta

selectarray<string>Required

Un elenco di colonne da restituire. Consulta lo schema di risposta per gli identificatori di colonna validi.

Example:["field_a","field_b"]

whereobject

L'espressione del filtro. Sono riconosciuti i seguenti identificatori di colonna (che differiscono dagli identificatori riconosciuti dal parametro select).

cited_domain: Il dominio di una pagina utilizzata per generare la risposta.
tipo: dominio

cited_domain_subdomains: Il dominio di una pagina utilizzata per generare la risposta. Verrà considerata valida anche qualsiasi sottodominio del dominio indicato.
tipo: stringa

cited_url_exact: L'URL di una pagina utilizzata per generare la risposta.
tipo: stringa

cited_url_prefix: L'URL di una pagina utilizzata per generare la risposta. Verrà considerato valido qualsiasi URL che inizi con questo prefisso.
tipo: stringa

question: La domanda posta dall'utente.
tipo: stringa

response (10 unità): La risposta del modello.
tipo: stringa

search_queries: La query di ricerca usata dal chatbot per trovare informazioni per la risposta. Nota: se data_source non include chatgpt o perplexity, questo campo sarà sempre vuoto.
tipo: stringa

topic: L'argomento della query.
tipo: stringa

tags_filterobject

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"]}]}.

countryarray<string>

Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

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#/...

promptsstring

Il tipo di prompt da usare. Se non specificato, verranno usati entrambi. I prompt personalizzati richiedono che venga fornito un report_id.

Allowed values:ahrefscustom

data_sourcearray<string>Required

Un elenco di modelli di chatbot. I modelli Google (google_ai_overviews, google_ai_mode) non possono essere combinati tra loro né con modelli non Google.

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok

marketarray<string>

Un elenco dei mercati di nicchia dei tuoi brand.

competitorsarray<object>

Un elenco di nomi e siti web dei concorrenti da cercare.

At least one of names or url_groups is required

namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstringrequired

Il dominio del target

Example:ahrefs.com

scopestringrequired

Ambito del target.

Allowed values:urlpathdomainsubdomains

brandsarray<object>

Un elenco di nomi e siti web dei brand da cercare.

At least one of names or url_groups is required

namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstringrequired

Il dominio del target

Example:ahrefs.com

scopestringrequired

Ambito del target.

Allowed values:urlpathdomainsubdomains

outputstring

Il formato di output.

Allowed values:jsoncsvxmlphp

Risposte

metricsarray<object>

brandstring

Nome del brand (il tuo brand o un concorrente fornito nella richiesta).

no_tracked_brandsinteger

Menzioni stimate provenienti da risposte relative al mercato specificato che non menzionano alcun brand fornito (il valore è zero quando market non è specificato).

only_competitors_brandsinteger

Menzioni stimate provenienti da risposte che menzionano solo i brand dei concorrenti.

only_target_brandinteger

Menzioni stimate provenienti da risposte che menzionano solo il tuo brand.

target_and_competitors_brandsinteger

Menzioni stimate provenienti da risposte che menzionano sia il tuo brand sia i brand dei concorrenti.

totalinteger

Totale menzioni stimate per il tuo brand (include sia only_target_brand sia target_and_competitors_brands).