Docs
Cerca nella documentazione...⌘K

Risposte AI

API + MCP
POST/v3/brand-radar/ai-responses

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

volume_rangeobject

L’intervallo di volume da usare come filtro.

frominteger
tointeger
selectarray<string>Required

Un elenco di campi da restituire.

Example:["field_a","field_b"]
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"]}]}.

limitinteger

Il numero di risultati da restituire.

Default:1000
datestring (date)

La data da cercare nel formato YYYY-MM-DD.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
order_bystring

Una colonna in base alla quale ordinare i risultati.

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

competitorsarray<object>

Un elenco di nomi e siti web dei concorrenti 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
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:jsonphp

Risposte

ai_responsesarray<object>
countrystring

Il paese della domanda.

data_sourcestring

Il modello di chatbot che ha generato la risposta.

last_updatedstring (date)

La data dell’ultimo aggiornamento dei dati.

linksarray<object>

(10 unità) I link utilizzati per la risposta.

urlstring
titlestring or null
questionstring

La domanda posta dall'utente.

responsestring

(10 unità) La risposta del modello.

search_queriesarray<string>

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

tagsarray<string>

Tag assegnati alla query.

volumeinteger

(10 unità) Ricerche mensili stimate. Il dato si basa sulle nostre stime per Google, sommando il volume di ricerca delle parole chiave correlate in cui questa domanda compare nella sezione "People Also Ask".