Docs
Cerca nella documentazione...⌘K

Storico panoramica - Menzioni

API + MCP
POST/v3/brand-radar/mentions-history

Le 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

whereobject

L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).

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

date_tostring (date)

La data di fine del periodo storico nel formato YYYY-MM-DD.

date_fromstring (date)Required

La data di inizio del periodo storico nel formato YYYY-MM-DD.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
report_idstring

L'ID del report da usare. Se ne viene specificato uno, gli altri parametri vengono presi dal report (mercato, paese, filtri). Se vengono forniti paese o filtri, sovrascrivono quelli del report. Puoi trovarlo nell'URL del tuo report 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 di keyword di Google (google_ai_overviews_keywords, google_ai_mode_keywords) non possono essere combinati tra loro né con altri modelli.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

Un elenco dei mercati di nicchia dei tuoi brand. Deprecato il 2026-05-18, questo parametro non avrà alcun effetto poco dopo questa data.

brandsarray<object>

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

Default:
At least one of names or url_groups is required
namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

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>
datestring (date)
mentionsinteger

Menzioni stimate dalle risposte che menzionano il brand.