Panoramica - Menzioni

API + MCP

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

Parametri della query

wherestring

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

selectstringObbligatorio

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

countrystring

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

Valori consentiti: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.

Valori consentiti:ahrefscustom

data_sourcestringObbligatorio

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

Valori consentiti:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok

Example:chatgpt,perplexity

marketstring

Un elenco, separato da virgole, dei mercati di nicchia dei tuoi brand.

competitorsstring

Un elenco, separato da virgole, dei concorrenti dei tuoi brand.

brandstring

Un elenco, separato da virgole, dei brand da cercare. Almeno uno tra brand, competitors, market o where non deve essere vuoto.

outputstring

Il formato di output.

Valori consentiti: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).