API per la visibilità AI

Le risposte AI, come dati. Una sola API.

Accesso programmatico a come ChatGPT, AI Overview di Google, Gemini, Perplexity, Claude e altri 10 motori citano, posizionano e menzionano qualsiasi brand: gli stessi dati giornalieri che alimentano l’app GeoGen.

Ottieni una chiave API Leggi la documentazione

Crea una chiave del workspace nell’app: Settings → Workspaces → il tuo workspace → API Keys.

# Visibility trend for one tracked brand, last 7 days
$ curl "https://api.geogen.io/v1/trends/visibility?entityId=$ENTITY_ID&period=7d" \
    -H "Authorization: Bearer $GEOGEN_API_KEY"

{
  "success": true,
  "data": [
    { "date": "2026-10-05", "score": 71.2 },
    { "date": "2026-10-06", "score": 73.9 },
    { "date": "2026-10-07", "score": 78.4 }
  ]
}

import os, requests

r = requests.get(
    "https://api.geogen.io/v1/competitors",
    params={"entityId": os.environ["ENTITY_ID"]},
    headers={"Authorization": f"Bearer {os.environ['GEOGEN_API_KEY']}"},
)
for row in r.json()["data"]:
    print(row["rank"], row["name"], row["visibility"])

$ npm install -g @geogenio/cli
$ geogen login
$ geogen competitors --entity $ENTITY_ID --json | jq '.[0]'

Cosa puoi interrogare

Entità e prompt

Crea e gestisci i brand monitorati e i prompt che vengono eseguiti su di essi.
- GET/entities
- POST/entities
- PATCH/entities
- GET/entities/check-domain
- GET/entities/prompts
- POST/entities/addprompt
- PATCH/entities/updateprompt
- DELETE/entities/deleteprompt
Visibilità e trend

Trend giornalieri di visibilità, sentiment e citazioni per brand, filtrabili per modello, tag e prompt.
- GET/trends/visibility
- GET/trends/sentiment
- GET/trends/citations
- GET/entities/tracking-status
Risposte

Ogni risposta AI con lo stato della menzione, più il dettaglio completo: menzioni, citazioni e fan-out.
- GET/responses
- GET/responses/details
Citazioni e fan-out

I domini e gli URL che l’AI cita e le ricerche web eseguite mentre rispondeva.
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
Concorrenti

La classifica dello share of voice: visibilità, menzioni, posizione media e sentiment per brand.
- GET/competitors
Azioni e workspace

Raccomandazioni generate dall’AI, la task board, modelli, membri, tag e gruppi di domini.
- GET/entities/actions
- POST/entities/actions/update-status
- GET/models
- GET/workspace
- GET/domain-groups

Costruita come un’infrastruttura

L’API è in beta: gli endpoint possono evolvere e le modifiche vengono annunciate nel changelog.

URL base: https://api.geogen.io/v1
Autenticazione: Chiave del workspace (wsk_…) tramite Authorization: Bearer o X-API-Key
Formato: JSON, con paginazione total / limit / offset
Limiti di frequenza: 100 letture / min e 20 scritture / min per chiave; più alti su richiesta
Freschezza: Ogni prompt rieseguito ogni giorno; interroga /entities/tracking-status per i nuovi dati
Specifica: OpenAPI 3 su docs.geogen.io/openapi.json

Cosa ci costruiscono i team

Piattaforme e provider di hosting
Mostra ai clienti come i motori AI vedono il loro sito, dentro il tuo pannello di controllo o SaaS.
Agenzie
Alimenta dashboard cliente e report mensili con visibilità, citazioni e concorrenti.
Fornitori di tool SEO
Aggiungi un modulo di visibilità AI senza costruire una pipeline di scraping delle risposte.
Team dati e BI
Pianifica il prelievo nel tuo data warehouse e incrocia la visibilità AI con traffico e ricavi.

Stessi dati, tre superfici

CLI geogen

Ogni funzione dell’API dal tuo terminale, con --json su ogni comando per script e CI.

Stessi dati, tre superfici

Server MCP

Lascia che Claude, Cursor, Windsurf, GitHub Copilot o agenti OpenAI interroghino la tua visibilità AI in linguaggio naturale.

Domande frequenti

Che cos’è un’API di visibilità AI?

Un’API di visibilità AI restituisce dati strutturati su come gli assistenti AI rispondono alle domande su un mercato: quali brand citano, in quale posizione e con quale tono, quali fonti citano e quali ricerche eseguono. L’API di GeoGen li espone per 15 motori, aggiornati ogni giorno.

Quali motori copre l’API?

Gli stessi 15 motori dell’app: ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Perplexity, Microsoft Copilot, Mistral, Brave Leo, Claude Haiku letti come li vedono gli utenti, e DeepSeek, MiMo, Grok, Qwen, Claude Sonnet, Claude Opus interrogati a livello di modello. GET /models li elenca.

Come mi autentico?

Crea una chiave API del workspace nell’app (Settings → Workspaces → il tuo workspace → API Keys) e inviala come Authorization: Bearer wsk_… oppure nell’header X-API-Key. Tieni le chiavi lato server.

Quanto sono aggiornati i dati?

Ogni prompt viene eseguito ogni giorno su ogni motore del piano. Interroga GET /entities/tracking-status per sapere quando è terminata l’ultima verifica e quando è prevista la prossima.

Esiste un’API ufficiale per Google AI Overviews?

Google non offre un’API pubblica per le risposte di AI Overview. GeoGen legge AI Overview e AI Mode come li vedono gli utenti e restituisce i risultati (menzioni, posizioni e fonti citate) tramite la sua API.

Posso rivendere o integrare i dati nel mio prodotto?

Sì, con un accordo di partnership. Piattaforme e fornitori di tool SEO integrano i dati GeoGen nei propri prodotti; parla con il team partnership di volumi e condizioni di ridistribuzione.

Sii il brand che l’AI consiglia.

Scopri come ChatGPT, AI Overview di Google, Gemini, Perplexity e altri 9 motori AI parlano di te: risultati in pochi minuti.

Inizia ora Prenota una demo