AI Search Visibility
La visibilità nella ricerca AI indica quanto spazio ha un brand nelle risposte generate dall’IA: quante risposte di Google AI Overview o ChatGPT lo nominano o lo citano, quanta domanda mensile c’è dietro quelle domande, su quali siti si basano le risposte e quali altri brand vengono nominati nello stesso contesto. Misurata fianco a fianco per un brand e i suoi concorrenti, mostra chi l’IA raccomanda in una categoria, quali editori orientano quella raccomandazione e se la visibilità cresce dopo un lavoro sui contenuti o di PR.
Funzionalità della AI Search Visibility API
- Un totale per tutta la presenzaLa riga total riporta mentions_count, il numero di risposte AI che nominano o citano il dominio o la parola chiave, e ai_search_volume, la domanda mensile complessiva delle loro domande.
- I domini citati dalle risposteLe righe source_domain ordinano i 10 siti che queste risposte citano di più e mostrano quali editori influenzano ciò che l’IA dice di te.
- I domini nei risultati web letti dall’IALe righe search_result_domain ordinano i siti comparsi nei risultati web che l’IA ha esaminato prima di rispondere, cioè l’elenco di letture dietro le risposte.
- Brand e categorie nominati accanto a teSu chat_gpt le righe brand e brand_category elencano i brand e le categorie di prodotto presenti nelle stesse risposte, un’indicazione diretta di chi ti viene affiancato.
- Dominio o parola chiave come soggettoMisura un sito con target oppure un nome di prodotto, una categoria o un tema con query, sia su AI Overview sia su ChatGPT.
Parametri della AI Search Visibility API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio (almeno uno) | Dominio da misurare, ad esempio hubspot.com, senza percorso di pagina. Invia target oppure query. |
query | Obbligatorio (almeno uno) | Parola chiave, nome del brand o tema da misurare, 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 e aggiunge righe sui brand. |
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. |
Come usare la AI Search Visibility API
Invia un dominio o una parola chiave e leggi il totale e ogni ripartizione.
- Invia {"target": "hubspot.com", "platform": "chat_gpt"} in POST a /v1/ai-search/llm-brand-metrics.
- Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
- Leggi results.items raggruppando per dimension: prima total, poi source_domain, search_result_domain, brand e brand_category in ordine di rank.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-brand-metrics" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"hubspot.com","platform":"chat_gpt"}'Casi d’uso della AI Search Visibility API
- Confrontare la share of voice AI con i concorrenti: Interroga sulla stessa piattaforma il tuo dominio e quelli di due concorrenti e confronta mentions_count e ai_search_volume delle righe total per vedere chi l’IA nomina più spesso.
- Trovare gli editori dietro la tua presenza AI: Usa le righe source_domain per scegliere siti di recensioni, testate e community da contattare, perché sono le pagine su cui si basano le risposte AI che ti nominano.
- Seguire la visibilità dopo un lancio o una campagna: Salva la riga total a intervalli regolari e confrontala prima e dopo un lancio di prodotto, un’azione di PR o un aggiornamento dei contenuti.
Consigli degli esperti per la AI Search Visibility API
- Se ti servono le righe brand e brand_category, imposta platform su chat_gpt; le richieste su AI Overview restituiscono il totale e le ripartizioni per dominio.
- Quando confronti più brand, mantieni uguali piattaforma, mercato e lingua, così i totali misurano lo stesso insieme di risposte.
- Se ti servono le pagine precise invece dei domini, usa la LLM Top Sources API con content_type impostato su pages per lo stesso target o query.
- Se la riga total di un dominio mostra poche menzioni, interroga anche il nome del brand come query, perché una risposta può nominare un brand senza collegarne il sito.
API correlate
Oltre alla AI Search Visibility 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.
- 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.