ai-search/
google-ai-mode

Invia una ricerca e ricevi la risposta completa che Google AI Mode scrive, in Markdown, con l’elenco senza doppioni delle fonti citate, ognuna con titolo, URL, dominio ed estratto.

Google AI Mode API

Risposta completa in Markdown
Fonti citate
Qualsiasi paese e lingua
Una riga per ricerca
2 crediti per richiesta
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

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

ParametriObbligatorioDescrizione
queryObbligatorioRicerca da porre ad AI Mode, ad esempio best crm for startups.
location_codeFacoltativoCodice di località del mercato di ricerca. Predefinito 2840 (Stati Uniti).
location_nameFacoltativoNome del mercato in alternativa a location_code. Se compilato, viene usato al posto di location_code.
language_codeFacoltativoCodice della lingua della ricerca. Predefinito en.
languageFacoltativoNome 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.

  1. Invia {"query": "best crm for startups", "location_code": 2840, "language_code": "en"} in POST a /v1/ai-search/google-ai-mode.
  2. Interroga GET /v1/tasks/{task_id} finché status non vale succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

Google AI Mode API — FAQ

Google AI Mode API restituisce la risposta completa che AI Mode scrive per una query, in Markdown, insieme alle fonti citate senza doppioni e ai loro titoli, URL, domini ed estratti.

AI Mode è una scheda conversazionale a sé nella Ricerca Google che scrive una risposta completa per ogni query, ed è quella scheda che legge questa API; le risposte di AI Overview sono coperte dalla LLM Mentions API.

Sì. I valori predefiniti sono Stati Uniti (2840) e inglese (en), e si cambiano con location_code o location_name e language_code o language.

Ogni richiesta costa 2 crediti e restituisce una riga con la risposta e le sue fonti.