API de visibilidade em IA

Respostas de IA, como dados. Uma só API.

Acesso programático ao modo como o ChatGPT, o Google AI Overviews, o Gemini, o Perplexity, o Claude e mais 10 motores mencionam, classificam e citam qualquer marca. São os mesmos dados diários que alimentam a aplicação GeoGen.

Obter uma chave de API Ler a documentação

Crie uma chave de espaço de trabalho na aplicação: Definições → Espaços de trabalho → o seu espaço de trabalho → 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 pode consultar

Entidades e prompts

Crie e gira as marcas monitorizadas e os prompts executados sobre elas.
- 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, etiqueta e prompt.
- GET/trends/visibility
- GET/trends/sentiment
- GET/trends/citations
- GET/entities/tracking-status
Respostas

Cada resposta de IA com o estado de menção, mais os detalhes completos: menções, citações e fan-outs.
- GET/responses
- GET/responses/details
Citações e fan-outs

Os domínios e URL que a IA cita e as pesquisas na web que executou ao responder.
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
Concorrentes

A classificação de quota de voz: visibilidade, menções, posição média e sentimento por marca.
- GET/competitors
Ações e espaço de trabalho

Recomendações geradas por IA, o quadro de tarefas, modelos, membros, etiquetas 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 alterações são anunciadas nas novidades do produto.

URL base: https://api.geogen.io/v1
Autenticação: Chave de espaço de trabalho (wsk_…) via Authorization: Bearer ou X-API-Key
Formato: JSON, paginado com total / limit / offset
Limites de pedidos: 100 leituras / min e 20 escritas / min por chave; mais alto a pedido
Atualidade: Cada prompt é executado de novo todos os dias; consulte /entities/tracking-status para saber de dados novos
Especificação: OpenAPI 3 em docs.geogen.io/openapi.json

O que as equipas constroem com ela

Plataformas e fornecedores de alojamento
Mostre aos clientes como os motores de IA veem o seu site, dentro do seu painel de controlo 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
Acrescente um módulo de visibilidade em IA sem construir um sistema de recolha de respostas.
Equipas de dados e BI
Agende extrações para o seu armazém de dados e cruze a visibilidade em IA com tráfego e receitas.

Os mesmos dados, três superfícies

CLI geogen

Todas as capacidades da API a partir do terminal, com --json em todos os comandos para scripts e CI.

Os mesmos dados, três superfícies

Servidor MCP

Deixe o Claude, o Cursor, o Windsurf, o GitHub Copilot ou agentes OpenAI consultar a sua visibilidade em IA em linguagem simples.

Perguntas frequentes

O que é uma API de visibilidade em IA?

Uma API de visibilidade em IA devolve dados estruturados sobre como os assistentes de IA respondem a perguntas sobre um mercado: que marcas mencionam, em que posição e tom, que fontes citam e que pesquisas executam. A API da GeoGen disponibiliza isto para 15 motores, atualizado todos os dias.

Que motores abrange a API?

Os mesmos 15 motores da aplicação: ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Perplexity, Microsoft Copilot, Mistral, Brave Leo, Claude Haiku lidos como os utilizadores os veem, e DeepSeek, MiMo, Grok, Qwen, Claude Sonnet, Claude Opus consultados no modelo. O GET /models lista-os.

Como me autentico?

Crie uma chave de API de espaço de trabalho na aplicação (Definições → Espaços de trabalho → o seu espaço de trabalho → Chaves de API) e envie-a como Authorization: Bearer wsk_… ou no cabeçalho X-API-Key. Mantenha as chaves do lado do servidor.

Quão atuais são os dados?

Cada prompt é executado todos os dias em todos os motores do plano. Consulte GET /entities/tracking-status para saber quando terminou a última verificação e quando está agendada a seguinte.

Existe uma API oficial do Google AI Overviews?

A 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 utilizadores os veem e devolve as menções, as posições e as fontes citadas através da sua API.

Posso revender ou integrar os dados no meu produto?

Sim, ao abrigo de um acordo de parceiro. Plataformas e fornecedores de ferramentas de SEO integram os dados da GeoGen nos seus produtos; fale com as parcerias sobre volume e condições de redistribuição.

Seja a marca que a IA recomenda.

Comece a monitorizar o que o ChatGPT, o Google AI Overviews, o Gemini, o Perplexity e mais 9 motores de IA dizem sobre si. Resultados em minutos.

Começar Agendar demonstração