Torna alle API
Dati di ricerca AI

AI Search API

Segui come AI Overview, ChatGPT e Google AI Mode rispondono alle domande del tuo mercato: le risposte che citano il tuo brand, quanto sei visibile e quali domini e pagine vengono citati.

API di AI Search disponibili

Usa LLM Mentions API per le risposte stesse, AI Search Visibility API per totali e ripartizioni, LLM Top Sources API per i domini o le pagine più citati e Google AI Mode API per la risposta completa di AI Mode a una ricerca.

Quali dati di ricerca AI puoi recuperare?

Parti da un dominio, un brand o una parola chiave e scopri come lo trattano le risposte AI.

Risposte AI che ti citano

La domanda, la risposta completa in Markdown, le fonti citate, i risultati web su cui si basa, i brand nominati e le ricerche di approfondimento eseguite.

Metriche di visibilità

Menzioni totali e volume di ricerca AI per un dominio o una parola chiave, ripartiti per dominio citato, dominio dei risultati di ricerca, brand e categoria di brand.

Fonti più citate

I dieci domini o le singole pagine che le risposte AI citano di più su un argomento, con numero di menzioni e volume di ricerca AI.

Risposte di Google AI Mode

La risposta completa di AI Mode a una ricerca in qualsiasi paese e lingua, con ogni fonte citata e relativi titolo, dominio ed estratto.

Storico delle risposte

Date di prima e ultima rilevazione per ogni risposta, così da distinguere le menzioni nuove da quelle stabili.

Monitoraggio delle menzioni o risposte di Google AI Mode

Usa le API delle menzioni per misurare un brand su molte risposte AI e Google AI Mode per leggere una risposta per intero.

ConfrontoLLM Mentions, AI Search Visibility e LLM Top SourcesGoogle AI Mode API
InputUn dominio in target o una parola chiave in queryUna ricerca in query
Superfici AIAI Overview, oppure ChatGPT con platform chat_gptGoogle AI Mode
RisultatoRisposte, righe di metriche o le dieci fonti più citateUna risposta completa con ogni fonte citata
Ideale perQuota di risposte AI, concorrenti e obiettivi di citazioneCosa dice AI Mode alle persone in un determinato mercato
Prezzo40 crediti per richiesta più 0,5 per riga2 crediti per richiesta

Come funziona l’API di AI Search

Tutte le API di AI Search seguono lo stesso flusso di attività asincrone.

  1. 1. Invia un dominio o una parola chiave

    Invia con POST un dominio in target o una parola chiave in query a /v1/ai-search/llm-mentions, /v1/ai-search/llm-brand-metrics o /v1/ai-search/llm-top-mentioned, oppure una ricerca a /v1/ai-search/google-ai-mode.

  2. 2. Segui l’attività

    Interroga GET /v1/tasks/{task_id} fino a quando status diventa succeeded.

  3. 3. Leggi i risultati

    Leggi le risposte, le righe di metriche o le fonti in results.items.

Trova le risposte AI che citano un dominio

Autenticati con la tua chiave API SocQ e invia il dominio da monitorare. Ogni richiesta costa 40 crediti più 0,5 crediti per risposta restituita.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","platform":"google","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read the AI answers in results.items

Casi d’uso comuni dell’API di AI Search

Report GEO

Monitora ogni mese menzioni e volume di ricerca AI del tuo dominio e riporta come cambia la tua quota di risposte AI.

Benchmark sui concorrenti

Confronta i brand che compaiono accanto al tuo nelle risposte di ChatGPT e quanto spesso viene nominato ciascuno.

Outreach per le citazioni

Individua i domini e le pagine che le risposte AI citano di più sul tuo argomento, poi ottieni visibilità o link su quelle pagine.

Pianificazione dei contenuti

Trasforma le domande e le ricerche di approfondimento dietro le risposte AI in brief per pagine che l’IA può citare.

Verifiche su AI Mode

Leggi cosa dice Google AI Mode della tua categoria in ogni mercato e verifica se le tue pagine sono tra le sue fonti.

Regole di richiesta e prezzi

Queste regole valgono per tutte le API di AI Search.

  • LLM Mentions, AI Search Visibility e LLM Top Sources accettano un dominio in target o una parola chiave in query e leggono AI Overview per impostazione predefinita oppure ChatGPT con platform chat_gpt.
  • I dati di ChatGPT coprono gli Stati Uniti in inglese e aggiungono righe sui brand; i dati di AI Overview seguono location_code e language_code.
  • LLM Mentions restituisce da 1 a 1.000 risposte, 100 per impostazione predefinita; LLM Top Sources restituisce fino a 10 domini o pagine, scelti con content_type.
  • Google AI Mode accetta una ricerca in query e restituisce una risposta per il paese e la lingua scelti.
  • LLM Mentions, AI Search Visibility e LLM Top Sources costano 40 crediti per richiesta più 0,5 crediti per riga; Google AI Mode costa 2 crediti per richiesta.

Domande frequenti sull’API di AI Search

Che cos’è AI Search API?

AI Search API è un insieme di endpoint per la generative engine optimization (GEO): restituisce le risposte di AI Overview, ChatGPT e Google AI Mode su un dominio, un brand o una parola chiave, con le fonti citate e la frequenza con cui compare un brand.

Quali API di AI Search sono disponibili?

LLM Mentions API, AI Search Visibility API, LLM Top Sources API e Google AI Mode API.

Quali assistenti AI sono coperti?

Google AI Overview e ChatGPT per menzioni, visibilità e fonti principali, e Google AI Mode per le risposte complete a una ricerca.

Devo inviare un dominio o una parola chiave?

Invia il tuo dominio in target per trovare le risposte che citano il tuo sito, oppure un brand o un argomento in query per trovare quelle che lo nominano, comprese quelle che citano un brand senza linkarne il sito.

Come vengono addebitate le richieste di AI Search?

LLM Mentions, AI Search Visibility e LLM Top Sources costano 40 crediti per richiesta più 0,5 crediti per riga restituita. Google AI Mode costa 2 crediti per richiesta.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.