LLM Top Sources
Le fonti principali degli LLM sono i siti e gli articoli su cui le risposte dell’IA si basano di più quando si chiede di un argomento: i domini o le pagine precise che Google AI Overview o ChatGPT citano in tutte le risposte su una parola chiave come crm software, ordinati per numero di risposte che li citano e per la domanda di ricerca servita da quelle risposte. La classifica è una lista già pronta per digital PR, guest post e recensioni, perché far entrare un prodotto nelle pagine più citate è la via più diretta per comparire nelle risposte costruite su di esse.
Funzionalità della LLM Top Sources API
- Domini o pagine precisecontent_type domains ordina interi siti con la home page in url; content_type pages ordina singoli articoli con l’URL della pagina, pronta da aprire e leggere.
- Ordinate per risposte che le citanomentions_count è il numero di risposte AI che citano ogni fonte, e rank ordina l’elenco dalla più citata in giù.
- La domanda dietro ogni fonteai_search_volume somma il volume di ricerca AI mensile delle domande le cui risposte citano la fonte, per separare le fonti con grande pubblico da quelle citate su domande di nicchia.
- Un argomento o un dominio come punto di partenzaUsa query per una parola chiave di categoria o target per un dominio, su Google AI Overview o su ChatGPT.
Parametri della LLM Top Sources API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio (almeno uno) | Dominio di cui si analizzano le risposte AI, ad esempio hubspot.com, senza percorso di pagina. Invia target oppure query. |
query | Obbligatorio (almeno uno) | Parola chiave o argomento di cui si analizzano le risposte AI, ad esempio crm software. 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. |
content_type | Facoltativo | domains (predefinito) ordina interi siti; pages ordina gli URL delle singole pagine. |
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 di fonti in classifica, da 1 a 10. Predefinito 10, che è anche il massimo. |
Come usare la LLM Top Sources API
Invia una parola chiave o un dominio e leggi le fonti citate in ordine di posizione.
- Invia {"query": "crm software", "platform": "google", "content_type": "domains"} in POST a /v1/ai-search/llm-top-mentioned.
- Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
- Leggi results.items in ordine di rank, con name e url per la fonte e mentions_count e ai_search_volume per il suo peso.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-top-mentioned" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"crm software","platform":"google","content_type":"domains"}'Casi d’uso della LLM Top Sources API
- Creare una lista di digital PR: Interroga la parola chiave della tua categoria con content_type pages e proponi agli autori degli articoli più citati di includere il tuo prodotto.
- Scegliere siti di recensioni e community su cui investire: Interroga ogni categoria in cui vendi con content_type domains e dai priorità ai siti in alto sia per mentions_count sia per ai_search_volume.
- Confrontare le fonti citate tra piattaforme di IA: Esegui la stessa parola chiave su google e su chat_gpt per capire se AI Overview e ChatGPT si affidano agli stessi editori.
- Prendere a modello le pagine di cui l’IA si fida già: Apri le pagine più citate su un argomento e studiane struttura, profondità e formato prima di scrivere le tue.
Consigli degli esperti per la LLM Top Sources API
- Se la classifica dei domini è dominata da grandi testate, passa content_type a pages per trovare articoli precisi in cui ottenere una menzione è realistico.
- Quando basta una lista più corta, abbassa results_limit, perché ogni fonte in classifica aggiunge 0,5 crediti alla base di 40 crediti.
API correlate
Oltre alla LLM Top Sources API, usa queste API quando ti serve un altro tipo di dati pubblici di AI Search.
- LLM Mentions API — Trova le AI Overview e le risposte di ChatGPT che citano un dominio o nominano una parola chiave, con risposta completa, fonti citate e volume di ricerca AI.
- 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.
- 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.