LLM Mentions
Una menzione LLM è una domanda a cui Google AI Overview o ChatGPT risponde citando un dominio o riprendendo una parola chiave, registrata con la risposta completa, le pagine citate, il modello che l’ha prodotta e quante volte la domanda viene posta ogni mese, oltre, per ChatGPT, ai brand nominati e alle ricerche aggiuntive eseguite. Lette insieme, queste risposte mostrano su quali domande un brand arriva agli utenti dell’IA, su quali fonti si basano i modelli e dove un prodotto viene descritto male, e alimentano audit GEO, piani editoriali e confronti con i concorrenti.
Funzionalità della LLM Mentions API
- Si parte da un dominio o da una parola chiavetarget cerca le risposte che citano un dominio come notion.so, query quelle che nominano una parola chiave o un brand, così segui sia il tuo sito sia il modo in cui si parla della tua categoria.
- La risposta come la legge l’utenteanswer conserva l’intera risposta in Markdown con titoli, elenchi e link nel testo, per citare o verificare le parole del modello.
- Ogni pagina citatasources riporta per ogni pagina citata posizione, titolo, URL, dominio, nome del sito ed estratto, e mostra quali contenuti hanno dato forma alla risposta.
- La domanda dietro ogni quesitoai_search_volume stima quante volte al mese viene posta la domanda, per distinguere le menzioni su domande molto richieste da quelle su domande rare.
- Brand, risultati web e ricerche aggiuntive su ChatGPTCon platform chat_gpt, brands elenca i brand nominati in ordine, search_results le pagine consultate da ChatGPT e fan_out_queries le ricerche extra che ha eseguito.
- Quando è stata registrata la rispostafirst_seen_at e last_seen_at datano ogni risposta e aiutano a separare le risposte consolidate da quelle recenti.
Parametri della LLM Mentions API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio (almeno uno) | Dominio da seguire nelle risposte AI, ad esempio hubspot.com, senza percorso di pagina. Invia target oppure query. |
query | Obbligatorio (almeno uno) | Parola chiave o nome del brand da seguire nelle risposte AI, ad esempio crm software, fino a 250 caratteri. Invia target oppure query. |
platform | Facoltativo | google legge Google AI Overview ed è il valore predefinito; chat_gpt legge le risposte di ChatGPT per gli Stati Uniti in inglese. |
location_code | Facoltativo | Codice di località del mercato. Predefinito 2840 (Stati Uniti), il mercato coperto dalle risposte di chat_gpt. |
location_name | Facoltativo | Nome del mercato in alternativa a location_code. Se compilato, viene usato al posto di location_code. |
language_code | Facoltativo | Codice della lingua delle risposte. Predefinito en, la lingua delle risposte di chat_gpt. |
language | Facoltativo | Nome della lingua in alternativa a language_code. Se compilato, viene usato al posto di language_code. |
results_limit | Facoltativo | Numero massimo di risposte, da 1 a 1000. Predefinito 100. |
Come usare la LLM Mentions API
Invia un dominio o una parola chiave e leggi una riga per ogni risposta AI.
- Invia {"target": "notion.so", "platform": "google", "results_limit": 100} in POST a /v1/ai-search/llm-mentions.
- Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
- Leggi le risposte in results.items e richiedi la pagina successiva con results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","platform":"google","results_limit":100}'Casi d’uso della LLM Mentions API
- Verificare la presenza di un dominio nelle risposte AI: Usa il tuo dominio come target, ordina per ai_search_volume e leggi answer e sources per capire quali domande molto richieste ti citano e come vieni descritto.
- Individuare le pagine di cui l’IA si fida in una categoria: Usa una parola chiave di categoria come query e conta domini e URL in sources per stilare l’elenco degli articoli da contattare o da superare.
- Confrontare i brand nelle risposte di ChatGPT: Con platform chat_gpt interroga il tuo brand e i concorrenti e confronta brands, con la posizione di ciascuno, sulle stesse domande.
- Pianificare contenuti dagli angoli scoperti: Raccogli question e fan_out_queries dalle risposte in cui il tuo brand manca e trasformali in brief per pagine che i modelli possano citare.
Consigli degli esperti per la LLM Mentions API
- Interroga un brand in entrambe le forme, il dominio in target e il nome in query, perché le citazioni di un sito e le menzioni di un nome restituiscono risposte diverse.
- Ottieni le risposte che ti servono in un’unica richiesta con un results_limit più alto, dato che la base di 40 crediti si applica a ogni richiesta.
- Conserva l’id di ogni riga e confronta last_seen_at all’esecuzione successiva per distinguere le risposte nuove da quelle già esaminate.
API correlate
Oltre alla LLM Mentions API, usa queste API quando ti serve un altro tipo di dati pubblici di AI Search.
- AI Search Visibility API — Misura quanto spesso le risposte AI nominano un dominio o una parola chiave, con volume di ricerca AI, domini più citati e, su ChatGPT, i brand nominati accanto.
- LLM Top Sources API — Classifica i 10 domini o pagine che AI Overview e ChatGPT citano di più per una parola chiave o un dominio, per menzioni e volume di ricerca AI.
- Google AI Mode API — Recupera la risposta completa di Google AI Mode per una ricerca in Markdown, con ogni fonte citata, per qualsiasi paese e lingua.