Docs
Cerca nella documentazione...⌘K

Risposte AI

API + MCP
GET/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.

Parametri della query

selectstringObbligatorio

Un elenco di campi separati da virgole da restituire. Campi disponibili: question, response, volume, country, links, search_queries, tags, data_source, last_updated.

wherestring

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

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

cited_domain_subdomains: Il dominio di una pagina utilizzata per generare la risposta. Verrà considerato corrispondente anche qualsiasi sottodominio del dominio specificato.
type: string

cited_url_exact: L’URL di una pagina utilizzata per generare la risposta.
type: string

cited_url_prefix: L’URL di una pagina utilizzata per generare la risposta. Verrà considerato corrispondente qualsiasi URL che inizia con questo prefisso.
type: string

question: La domanda posta dall’utente.
type: string

response (10 unità): La risposta del modello.
type: string

search_queries: 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.
type: string

topic: L’argomento della query.
type: string

limitinteger

Il numero di risultati da restituire.

Predefinita:1000
datestring (date)

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

countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
order_bystring

Una colonna in base alla quale ordinare i risultati.

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

Valori consentiti:ahrefscustom
data_sourcestringObbligatorio

Un elenco di modelli di chatbot separati da virgole. I modelli di keyword di Google (google_ai_overviews_keywords, google_ai_mode_keywords) non possono essere combinati tra loro né con altri modelli.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
marketstring

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

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: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".