Google AI Mode
Google AI Mode è la scheda conversazionale della Ricerca Google che scrive una risposta completa a una query invece di elencare link, indicando accanto al testo le pagine su cui si è basata. Leggere queste risposte per le ricerche che contano per un’azienda mostra cosa Google racconta di una categoria, se un sito è tra le fonti citate, quali concorrenti vengono consigliati e come cambia la risposta da un paese o da una lingua all’altra.
Funzionalità della Google AI Mode API
- L’intera risposta, formattataanswer contiene la risposta di AI Mode in Markdown con titoli, elenchi e tabelle, pronta da salvare, confrontare o mostrare.
- Ogni fonte citata, una volta solareferences elenca le fonti citate senza doppioni, ognuna con position, title, url, domain, nome del sito e l’estratto mostrato con la risposta.
- Scegli il mercatolocation_code o location_name e language_code o language fissano paese e lingua della ricerca, così la stessa query si legge in più mercati.
- Un link alla pagina dal vivourl apre la pagina di AI Mode per la stessa query, comodo per controllare una risposta a occhio.
Parametri della Google AI Mode API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Ricerca da porre ad AI Mode, ad esempio best crm for startups. |
location_code | Facoltativo | Codice di località del mercato di ricerca. Predefinito 2840 (Stati Uniti). |
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 della ricerca. Predefinito en. |
language | Facoltativo | Nome della lingua in alternativa a language_code. Se compilato, viene usato al posto di language_code. |
Come usare la Google AI Mode API
Invia una query di ricerca e leggi la risposta con le sue fonti.
- Invia {"query": "best crm for startups", "location_code": 2840, "language_code": "en"} in POST a /v1/ai-search/google-ai-mode.
- Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
- Leggi l’unica riga in results.items: answer per il testo e references per le pagine citate.
curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"best crm for startups","location_code":2840,"language_code":"en"}'Casi d’uso della Google AI Mode API
- Verificare se le tue pagine sono citate: Esegui le tue query prioritarie, cerca il tuo dominio in references e annota la posizione e l’estratto mostrati da Google.
- Vedere quali brand consiglia AI Mode: Leggi answer per le ricerche con intento d’acquisto, come i migliori strumenti della tua categoria, e registra quali prodotti vengono nominati e in che ordine.
- Confrontare le risposte tra mercati: Poni la stessa query con impostazioni diverse di paese e lingua e localizza i contenuti dove AI Mode racconta a ogni mercato una storia diversa.
Consigli degli esperti per la Google AI Mode API
- Se segui le risposte nel tempo, salva answer in Markdown e confronta le versioni: i cambi di formulazione emergono come diff di testo.
- Quando una risposta cita la pagina di un concorrente, leggi l’estratto della relativa voce in references per capire su quale passaggio si è basata Google.
- Se ti servono risposte AI su molte domande anziché su una sola ricerca, usa la LLM Mentions API con il tuo dominio come target.
API correlate
Oltre alla Google AI Mode 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.
- 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.