ai-search/
llm-brand-metrics

Conta quante risposte di Google AI Overview o ChatGPT nominano un dominio o una parola chiave, con il volume di ricerca AI complessivo, i domini più citati e i brand che compaiono accanto.

AI Search Visibility API

Share of voice
Domini citati
Brand nominati accanto
AI Overview e ChatGPT
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

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

ParametriObbligatorioDescrizione
targetObbligatorio (almeno uno)Dominio da misurare, ad esempio hubspot.com, senza percorso di pagina. Invia target oppure query.
queryObbligatorio (almeno uno)Parola chiave, nome del brand o tema da misurare, ad esempio crm software. 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 e aggiunge righe sui brand.
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.

Come usare la AI Search Visibility API

Invia un dominio o una parola chiave e leggi il totale e ogni ripartizione.

  1. Invia {"target": "hubspot.com", "platform": "chat_gpt"} in POST a /v1/ai-search/llm-brand-metrics.
  2. Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

AI Search Visibility API — FAQ

AI Search Visibility API misura quanto spesso le risposte di Google AI Overview o ChatGPT nominano un dominio o una parola chiave, con il volume di ricerca AI complessivo, i domini citati e consultati e, su ChatGPT, i brand e le categorie nominati accanto.

Una riga di totale, poi fino a 10 righe per ripartizione: domini citati, domini dei risultati di ricerca e, su chat_gpt, brand e categorie di brand.

mentions_count è il numero di risposte AI che nominano o citano quel dominio, brand o categoria, e ai_search_volume è il volume di ricerca AI mensile complessivo delle domande di quelle risposte.

Ogni richiesta costa 40 crediti più 0,5 crediti per riga restituita, e i 40 crediti si applicano anche quando nessuna risposta nomina il dominio o la parola chiave.