API REST
A API de visibilidade e rastreamento de ranking em IA para o seu stack de relatórios
Leve os dados de visibilidade, prompts, respostas, citações e concorrentes da Geoptie para o BigQuery, o Looker Studio, painéis de clientes ou o seu próprio produto. Uma chave bearer, JSON via HTTPS e nenhuma cota mensal de requisições.
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 estável
7
motores de IA cobertos
120/min
requisições, sem limite mensal
$99
por mês, plano Profissional
Com a confiança de equipes de marketing e agências
O que é uma API de visibilidade em IA?
Uma API de visibilidade em IA retorna como motores de IA como ChatGPT, Claude, Perplexity, Gemini e as respostas de IA do Google mencionam e citam uma marca, em forma de dados que seus próprios sistemas podem usar. Ela também funciona como uma API de rank tracker de IA: visibilidade e posição para cada prompt monitorado, em cada motor, todos os dias.
A API REST da Geoptie entrega as mesmas métricas do painel, então os números em um data warehouse, em um painel de BI, em um relatório de cliente ou em um alerta no Slack batem com o que sua equipe vê.
Sua primeira requisição em menos de um minuto
Crie uma chave no painel e envie-a como bearer token. GET /v1/brands confirma que a chave funciona e retorna os ids de marca que todos os outros endpoints usam.
Configure em três passos
- 1
Crie uma chave
No painel, em Chaves de API, para todo o espaço de trabalho ou para marcas escolhidas.
- 2
Chame GET /v1/brands
Ela confirma que a chave funciona e retorna os ids de marca que todos os outros endpoints usam.
- 3
Puxe os dados de que precisa
Visibilidade, prompts, respostas, citações e concorrentes, por marca e por motor.
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());Catálogo de endpoints
Marcas
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompts e respostas
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Citações
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Concorrentes
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Recomendações e auditorias
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Conteúdo
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
48 operações no total, incluindo atualizações e exclusões. A referência completa está na documentação da API.
Feita para relatórios em produção
A API retorna os números que o seu painel mostra, em um formato que vai direto para um data warehouse ou um relatório de cliente.
Os mesmos números do painel
Visibilidade, posição e share of voice pré-calculados, não linhas brutas para remontar, então o relatório do cliente bate com o que sua equipe vê.
Leitura e escrita
Monitore prompts, gerencie tópicos e concorrentes, trabalhe a fila de recomendações, rode auditorias e gere conteúdo pela mesma API.
Chaves por espaço de trabalho ou por marca
Dê a um cliente, a um painel ou a uma equipe interna uma chave que alcança só a marca deles. A revogação passa a valer em até um minuto.
Jobs ritmados e previsíveis
Paginação por cursor, datas ISO 8601 e cabeçalhos de rate limit em todas as respostas, para que um job agendado controle o próprio ritmo sem receber um 429.
Erros que dá para tratar
Códigos de status HTTP padrão com um código de erro estável, e um X-Request-Id em cada resposta para o suporte rastrear.
Versionamento estável
A v1 é estável. Novos campos são adicionados sem aviso, e mudanças incompatíveis saem como /v2 com 90 dias de antecedência.
O que as equipes constroem com ela
Painéis de clientes
Agências levam a visibilidade em IA de cada cliente para o Looker Studio ou para o próprio portal, com uma chave restrita por marca para cada cliente.
Sincronização com data warehouse
Um job noturno copia dados de visibilidade, citações e concorrentes para o BigQuery ou o Snowflake, ao lado dos dados de SEO e analytics.
Alertas
Uma verificação agendada envia um aviso ao Slack ou por e-mail quando um prompt prioritário cai em um motor.
Assistentes de IA
A mesma chave alimenta o servidor MCP da Geoptie para Claude Code, Cursor e Codex.
Incluído nos planos Profissional e Empresarial
Perguntas frequentes sobre a API de visibilidade em IA
Quais dados a API da Geoptie retorna?
Quais planos incluem acesso à API?
Como funciona a autenticação?
Quais são os limites de requisição da API?
Posso puxar dados de concorrentes pela API?
Posso dar a um cliente acesso à API só da marca dele?
Quais motores de IA a API cobre?
Também existe um servidor MCP?
Coloque a visibilidade em IA ao lado do resto dos seus dados
Comece no Profissional, crie uma chave e sua primeira requisição retorna suas marcas em menos de um minuto.
Começar