Risposte AI
API + MCPLe 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
Un elenco di colonne da restituire. Consulta lo schema di risposta per gli identificatori di colonna validi.
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
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"]}]}.
Il numero di risultati da restituire.
La data da cercare nel formato YYYY-MM-DD.
Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2).
Una colonna in base alla quale ordinare i risultati.
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#/...
Il tipo di prompt da usare. Se non specificato, verranno usati entrambi. I prompt personalizzati richiedono che venga fornito un report_id.
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.
Un elenco dei mercati di nicchia dei tuoi brand.
Un elenco di nomi e siti web dei concorrenti da cercare.
names or url_groups is requiredI nomi del brand/concorrente
Il dominio del target
Ambito del target.
Un elenco di nomi e siti web dei brand da cercare.
names or url_groups is requiredI nomi del brand/concorrente
Il dominio del target
Ambito del target.
Il formato di output.
Risposte
Il paese della domanda.
Il modello di chatbot che ha generato la risposta.
(10 unità) I link utilizzati per la risposta.
La domanda posta dall'utente.
(10 unità) La risposta del modello.
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.
Tag assegnati alla query.
(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".