ai-search/
llm-mentions

Trova le AI Overview e le risposte di ChatGPT che citano un dominio o nominano una parola chiave, con domanda, risposta completa in Markdown, fonti citate e volume di ricerca AI mensile.

LLM Mentions API

AI Overview e ChatGPT
Risposta completa
Fonti citate
Volume di ricerca AI
40 crediti per richiesta + 0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
targetObbligatorio (almeno uno)Dominio da seguire nelle risposte AI, ad esempio hubspot.com, senza percorso di pagina. Invia target oppure query.
queryObbligatorio (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.
platformFacoltativogoogle legge Google AI Overview ed è il valore predefinito; chat_gpt legge le risposte di ChatGPT per gli Stati Uniti in inglese.
location_codeFacoltativoCodice di località del mercato. Predefinito 2840 (Stati Uniti), il mercato coperto dalle risposte di chat_gpt.
location_nameFacoltativoNome del mercato in alternativa a location_code. Se compilato, viene usato al posto di location_code.
language_codeFacoltativoCodice della lingua delle risposte. Predefinito en, la lingua delle risposte di chat_gpt.
languageFacoltativoNome della lingua in alternativa a language_code. Se compilato, viene usato al posto di language_code.
results_limitFacoltativoNumero 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.

  1. Invia {"target": "notion.so", "platform": "google", "results_limit": 100} in POST a /v1/ai-search/llm-mentions.
  2. Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
  3. 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.

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.

Esplora altre piattaforme

Combina i dati di AI Search con i dati pubblici delle altre piattaforme social supportate.

LLM Mentions API — FAQ

LLM Mentions API restituisce, per un dominio o una parola chiave, le AI Overview di Google e le risposte di ChatGPT che citano quel dominio o nominano quella parola. Ogni riga contiene domanda, risposta completa, fonti citate, modello e volume di ricerca AI mensile della domanda.

Con platform google vengono lette le AI Overview di Google nel mercato scelto, con chat_gpt le risposte di ChatGPT per gli Stati Uniti in inglese.

target con un dominio trova le risposte che citano quel sito; query con una parola chiave o un nome di brand trova quelle che lo nominano. Ogni richiesta ne usa uno solo.

Nomi di brand, risultati web consultati e ricerche aggiuntive vengono registrati per le risposte di ChatGPT; imposta platform su chat_gpt per riceverli.

Ogni richiesta costa 40 crediti più 0,5 crediti per risposta restituita, e i 40 crediti si applicano anche quando nessuna risposta corrisponde.