API REST
Le API di visibilità e rank tracking IA per il tuo stack di reporting
Porta i dati di visibilità, prompt, risposte, citazioni e competitor da Geoptie in BigQuery, Looker Studio, dashboard per i clienti o nel tuo prodotto. Una sola chiave bearer, JSON su HTTPS e nessuna quota mensile di richieste.
ChatGPT
Claude
Perplexity
Gemini
AI Overviews- AI Mode
Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"{
"data": [
{
"id": "3f2a6c1e-0b7d-4e59-9a41-2c8d5e7f9b10",
"name": "Example Brand",
"domain": "example.com",
"engines": ["chatgpt", "claude", "perplexity", "gemini"],
"country": "US"
}
],
"has_more": false,
"next_cursor": null
}v1
API REST stabile
7
motori IA coperti
120/min
richieste, nessun tetto mensile
$99
al mese, piano Professionale
Scelto da team di marketing e agenzie
Che cos'è un'API di visibilità IA?
Un'API di visibilità IA restituisce il modo in cui motori IA come ChatGPT, Claude, Perplexity, Gemini e le risposte IA di Google menzionano e citano un brand, sotto forma di dati che i tuoi sistemi possono usare. Funziona anche come API di rank tracking IA: visibilità e posizione per ogni prompt monitorato, su ogni motore, ogni giorno.
Le API REST di Geoptie forniscono le stesse metriche della dashboard, così i numeri in un data warehouse, in una dashboard di BI, in un report per i clienti o in un alert su Slack corrispondono a ciò che vede il tuo team.
La tua prima richiesta in meno di un minuto
Crea una chiave nella dashboard e inviala come bearer token. GET /v1/brands verifica che la chiave funzioni e restituisce gli id dei brand usati da tutti gli altri endpoint.
Pronto in tre passaggi
- 1
Crea una chiave
Nella dashboard, sotto Chiavi API, per l'intero workspace o per i brand che scegli.
- 2
Chiama GET /v1/brands
Verifica che la chiave funzioni e restituisce gli id dei brand usati da tutti gli altri endpoint.
- 3
Estrai i dati che ti servono
Visibilità, prompt, risposte, citazioni e competitor, per brand e per motore.
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"import os, requests
r = requests.get(
"https://api.geoptie.com/v1/brands",
headers={"Authorization": f"Bearer {os.environ['GEOPTIE_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://api.geoptie.com/v1/brands", {
headers: { Authorization: `Bearer ${process.env.GEOPTIE_API_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
console.log(await r.json());Catalogo degli endpoint
Brand
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompt e risposte
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Citazioni
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Competitor
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Raccomandazioni e audit
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Contenuti
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
48 operazioni in totale, inclusi aggiornamenti ed eliminazioni. Il riferimento completo è nella documentazione API.
Pensate per il reporting in produzione
Le API restituiscono i numeri mostrati dalla tua dashboard, in un formato che entra direttamente in un data warehouse o in un report per i clienti.
Gli stessi numeri della dashboard
Visibilità, posizione e share of voice precalcolate, non righe grezze da ricomporre, così un report per i clienti corrisponde a ciò che vede il tuo team.
Lettura e scrittura
Monitora prompt, gestisci topic e competitor, lavora la coda delle raccomandazioni, esegui audit e genera contenuti tramite le stesse API.
Chiavi per workspace e per brand
Dai a un cliente, a una dashboard o a un team interno una chiave che raggiunge solo il suo brand. La revoca ha effetto entro un minuto.
Job cadenzati e prevedibili
Paginazione a cursore, date ISO 8601 e header di rate limit in ogni risposta, così un job pianificato regola il proprio ritmo senza incappare in un 429.
Errori su cui puoi agire
Codici di stato HTTP standard con un codice di errore stabile, e un X-Request-Id in ogni risposta per il tracciamento da parte del supporto.
Versioning stabile
La v1 è stabile. I nuovi campi vengono aggiunti senza preavviso, mentre le modifiche incompatibili arrivano come /v2 con 90 giorni di preavviso.
Cosa costruiscono i team
Dashboard per i clienti
Le agenzie portano la visibilità IA di ogni cliente in Looker Studio o nel proprio portale, con una chiave limitata per brand per ciascun cliente.
Sincronizzazione con il data warehouse
Un job notturno copia i dati di visibilità, citazioni e competitor in BigQuery o Snowflake, accanto ai dati SEO e di analytics.
Alert
Un controllo pianificato invia un messaggio su Slack o un'email quando un prompt prioritario cala su un motore.
Assistenti IA
La stessa chiave alimenta il server MCP di Geoptie per Claude Code, Cursor e Codex.
Domande frequenti sulle API di visibilità IA
Quali dati restituiscono le API di Geoptie?
Quali piani includono l'accesso alle API?
Come funziona l'autenticazione?
Quali sono i rate limit delle API?
Posso estrarre i dati dei competitor tramite le API?
Posso dare a un cliente l'accesso alle API solo per il suo brand?
Quali motori IA coprono le API?
C'è anche un server MCP?
Metti la visibilità IA accanto al resto dei tuoi dati
Inizia con Professionale, crea una chiave e la tua prima richiesta restituirà i tuoi brand in meno di un minuto.
Inizia