API de visibilidade em IA
Respostas de IA, como dados. Uma só API.
Acesso programático a como ChatGPT, Google AI Overviews, Gemini, Perplexity, Claude e mais 10 motores citam, ranqueiam e referenciam qualquer marca. São os mesmos dados diários que alimentam o app da GeoGen.
Crie uma chave de workspace no app: Configurações → Workspaces → seu workspace → Chaves de API.
# 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]' O que você pode consultar
-
Entidades e prompts
Crie e gerencie as marcas monitoradas e os prompts executados para cada uma.
- GET/entities
- POST/entities
- PATCH/entities
- GET/entities/check-domain
- GET/entities/prompts
- POST/entities/addprompt
- PATCH/entities/updateprompt
- DELETE/entities/deleteprompt
-
Visibilidade e tendências
Tendências diárias de visibilidade, sentimento e citações por marca, filtráveis por modelo, tag e prompt.
- GET/trends/visibility
- GET/trends/sentiment
- GET/trends/citations
- GET/entities/tracking-status
-
Respostas
Cada resposta de IA com o status de menção, além dos detalhes completos: menções, citações e fan-outs.
- GET/responses
- GET/responses/details
-
Citações e fan-outs
Os domínios e URLs que a IA cita e as buscas na web que ela fez ao responder.
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
-
Concorrentes
O ranking de share of voice: visibilidade, menções, posição média e sentimento por marca.
- GET/competitors
-
Ações e workspace
Recomendações geradas por IA, o quadro de tarefas, modelos, membros, tags e grupos de domínios.
- GET/entities/actions
- POST/entities/actions/update-status
- GET/models
- GET/workspace
- GET/domain-groups
Construída como infraestrutura
A API está em beta: os endpoints podem evoluir, e as mudanças são anunciadas nas novidades do produto.
- URL base
- https://api.geogen.io/v1
- Autenticação
- Chave de workspace (wsk_…) via Authorization: Bearer ou X-API-Key
- Formato
- JSON, paginado com total / limit / offset
- Limites de requisições
- 100 leituras / min e 20 escritas / min por chave; mais sob solicitação
- Atualização
- Cada prompt é executado de novo todo dia; consulte /entities/tracking-status para saber de dados novos
- Especificação
- OpenAPI 3 em docs.geogen.io/openapi.json
O que as equipes constroem com ela
Plataformas e empresas de hospedagem
Mostre aos clientes como os motores de IA enxergam o site deles, dentro do seu painel de controle ou SaaS.
Agências
Alimente os painéis dos clientes e os relatórios mensais com visibilidade, citações e concorrentes.
Fornecedores de ferramentas de SEO
Adicione um módulo de visibilidade em IA sem construir um pipeline de coleta de respostas.
Times de dados e BI
Agende extrações para o seu data warehouse e cruze a visibilidade em IA com tráfego e receita.
Os mesmos dados, três formas de acesso
CLI geogen
Todos os recursos da API no seu terminal, com --json em todos os comandos para scripts e CI.
Os mesmos dados, três formas de acesso
Servidor MCP
Deixe agentes do Claude, Cursor, Windsurf, GitHub Copilot ou OpenAI consultarem sua visibilidade em IA em linguagem natural.
Perguntas frequentes
O que é uma API de visibilidade em IA?
Uma API de visibilidade em IA retorna dados estruturados sobre como os assistentes de IA respondem a perguntas sobre um mercado: quais marcas citam, em que posição e tom, quais fontes referenciam e quais buscas fazem. A API da GeoGen expõe isso para 15 motores, atualizados todo dia.
Quais motores a API cobre?
Os mesmos 15 motores do app: ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Perplexity, Microsoft Copilot, Mistral, Brave Leo, Claude Haiku, lidos como os usuários veem, e DeepSeek, MiMo, Grok, Qwen, Claude Sonnet, Claude Opus, consultados direto no modelo. O GET /models lista todos.
Como me autentico?
Crie uma chave de API de workspace no app (Configurações → Workspaces → seu workspace → Chaves de API) e envie-a como Authorization: Bearer wsk_… ou no cabeçalho X-API-Key. Mantenha as chaves no servidor.
Quão atualizados são os dados?
Cada prompt roda todos os dias em todos os motores do plano. Consulte o GET /entities/tracking-status para saber quando a última verificação terminou e quando está agendada a próxima.
Existe uma API oficial do Google AI Overviews?
O Google não oferece uma API pública para as respostas do AI Overviews. A GeoGen lê o AI Overviews e o AI Mode como os usuários os veem e devolve as menções, posições e fontes citadas pela sua API.
Posso revender ou incorporar os dados no meu produto?
Sim, mediante um contrato de parceria. Plataformas e fornecedores de ferramentas de SEO incorporam os dados da GeoGen em seus produtos; fale com o time de parcerias sobre volume e condições de redistribuição.
Seja a marca que a IA recomenda.
Comece a monitorar o que ChatGPT, Google AI Overviews, Gemini, Perplexity e mais 9 motores de IA dizem sobre você. Resultados em minutos.