API de SEO para o seu próprio stack
Seus dados de SEO e de visibilidade em IA em um endpoint REST enxuto.
Leve dados do Google Search Console, de ranking e do AI Tracker direto para o seu produto, dashboard ou data warehouse. Autentique com uma chave Bearer do seu dashboard, chame a REST /v1 e receba JSON tipado — a mesma camada de dados canônica que alimenta o MCP da SEOcrawl AI. GA4, exportação completa da auditoria de site e OAuth de parceiros multi-tenant vêm na sequência.
Autentique uma vez. Chame a REST.
Gere um token Bearer no seu dashboard e mande no cabeçalho Authorization. A mesma chave vale para a API REST e para o servidor MCP.
URL base
https://api.seocrawl.ai/v1Cabeçalho Authorization
Authorization: Bearer sca_live_your_token_hereUma camada de dados, duas superfícies
Todo endpoint REST lê da mesma camada canônica das ferramentas do MCP — então o seu dashboard e os seus agentes de IA sempre veem os mesmos números. Estes grupos já estão na v1; a cobertura cresce de forma contínua.
Propriedades
Liste as propriedades do Search Console a que você tem acesso. Use o id de cada uma no caminho de todos os endpoints de dados.
- GET
/v1/propertiesAtivo
Google Search Console
Cliques, impressões, CTR e posição média — por consulta, página, intervalo de datas e período a período. O detalhe completo está na página da API do Google Search Console.
- GET
/v1/properties/{id}/gsc/summaryAtivo - GET
/v1/properties/{id}/gsc/compareAtivo - GET
/v1/properties/{id}/gsc/top-keywordsAtivo - GET
/v1/properties/{id}/gsc/top-pagesAtivo - GET
/v1/properties/{id}/gsc/keywords/detailAtivo - GET
/v1/properties/{id}/gsc/pages/detailAtivo
AI Tracker
Leia os prompts que você acompanha para menções de marca no ChatGPT, Claude, Gemini e Perplexity.
- GET
/v1/properties/{id}/ai-tracker/promptsAtivo
Tarefas
Leia e escreva tarefas de SEO — conecte o seu quadro de tarefas ao stack de gestão de projetos que você já usa.
- GET
/v1/properties/{id}/tasksAtivo - POST
/v1/properties/{id}/tasksAtivo - GET
/v1/properties/{id}/tasks/{ticketId}Ativo - PATCH
/v1/properties/{id}/tasks/{ticketId}Ativo - POST
/v1/properties/{id}/tasks/{ticketId}/commentsAtivo
GA4 e Indexação
Tráfego, referrers de IA e status de indexação. A conexão já está pronta; os endpoints REST estão chegando.
- GET
/v1/properties/{id}/ga4/summaryEm breve - GET
/v1/properties/{id}/indexation/summaryEm breve
Auditoria de site
Saúde do rastreamento, on-page, técnico e listas de problemas — o conjunto completo da auditoria, exposto via REST.
- GET
/v1/properties/{id}/audit/summaryEm breve - GET
/v1/properties/{id}/audit/issuesEm breve
Construída para produto, não para scraper
Uma REST de verdade, com autenticação Bearer, scopes e limite de taxa — dividindo uma camada de dados canônica com o MCP para que os números nunca divirjam.
REST enxuta, JSON tipado
Recursos previsíveis, verbos padrão, respostas JSON tipadas e erros conforme as RFC (401 não autenticado, 403 scope_required, 429 com Retry-After). Sem raspar HTML e sem exportação frágil.
Uma camada de dados canônica
Os endpoints REST e as ferramentas do MCP são irmãos sobre os mesmos provedores, com paridade testada em CI. O seu dashboard e os seus agentes de IA sempre veem os mesmos cliques, impressões e posições.
Chaves self-service
Crie e revogue tokens Bearer no seu dashboard em segundos. A mesma chave sca_live_ autentica a API REST e o servidor MCP — uma credencial, duas superfícies.
Limites de taxa documentados
60 requisições por minuto e 1.000 por hora por token, com resposta 429 + Retry-After clara. O limite da REST é um pool separado do uso do MCP — um nunca come o do outro.
Acesso por scopes
Scopes gerais de leitura e escrita protegem cada endpoint, aplicados no firewall com resposta de step-up padrão. Dê a cada chave só o que ela precisa.
Multi-tenant, em breve
Um fluxo Google OAuth por tenant para o parceiro conectar as propriedades de GSC de todos os clientes em uma conta só — com isolamento rígido de dados. Em desenvolvimento ativo; peça acesso antecipado.
Comece em 3 passos
Do zero à primeira chamada autenticada em poucos minutos.
Gere uma chave
Abra os tokens de API no seu dashboard e gere um token Bearer. Copie na hora, porque ele aparece uma vez só — começa com sca_live_.
Mande o cabeçalho
Passe Authorization: Bearer sca_live_… em cada requisição para https://api.seocrawl.ai/v1. A mesma chave também funciona no servidor MCP.
Puxe os dados
Chame GET /v1/properties para pegar um id de propriedade e depois acesse /v1/properties/{id}/… para desempenho do GSC, prompts do AI Tracker ou tarefas — e jogue o JSON direto no seu produto, dashboard ou warehouse.
Três caminhos até os seus dados
Os mesmos números, superfícies diferentes — escolha a que combina com o seu jeito de construir.
API REST
Para produto, dashboard e pipeline de dados. Autenticação Bearer, JSON tipado, limite de taxa. É esta página.
Servidor MCP
Para agentes de IA — Claude, ChatGPT e qualquer cliente MCP consultam os seus dados em linguagem natural.
Conhecer o MCPTerminal e CLI
Para script e CI/CD — controle os seus dados de qualquer agente de terminal que fale MCP.
Ver a CLIQuem constrói em cima da API
Times que querem dados de SEO e de visibilidade em IA dentro dos próprios sistemas.
SaaS e parceiros
Coloque métricas de SEO ao vivo dentro da interface do seu produto. Entregue dados do Search Console e de visibilidade em IA para os seus usuários sem construir o pipeline do zero.
Agências
Jogue os dados de cada cliente em um portal próprio, no Looker Studio ou na sua camada de relatórios — uma chave, todas as propriedades, sem exportação manual.
Times de dados
Leve dados de GSC, de ranking e do AI Tracker para o seu warehouse em rotina agendada. Cruze com receita e monte os modelos que os seus dashboards pedem.
Pessoas desenvolvedoras
Automatize checagens e alertas, sincronize tarefas com a sua ferramenta de PM e coloque o acompanhamento de visibilidade em IA nos apps que você já publica.
Perguntas frequentes
Existe mesmo uma API de SEO pública?
Existe — uma API REST /v1 com autenticação Bearer já está ativa, cobrindo desempenho do Search Console, propriedades, prompts do AI Tracker e tarefas, com a referência pública completa em api.seocrawl.ai/docs. Mais cobertura (GA4, exportação completa da auditoria de site) e OAuth de parceiros multi-tenant vêm na sequência. Precisa de algo que ainda não está ativo? Peça acesso antecipado.
Como eu me autentico?
Com um token Bearer. Gere uma chave sca_live_ no seu dashboard e mande em Authorization: Bearer <key> a cada requisição. Não existe fluxo OAuth para a sua própria conta — é só o cabeçalho.
É a mesma chave do MCP?
É. O mesmo token autentica a API REST e o servidor MCP, porque os dois leem de uma camada de dados canônica. Uma credencial, duas superfícies — e os mesmos números nas duas.
Quais são os limites de taxa?
60 requisições por minuto e 1.000 por hora por token. Ao estourar, você recebe um 429 com o cabeçalho Retry-After. O limite da REST é contado separado do uso do MCP, então os dois nunca brigam pelo mesmo orçamento.
Dá para conectar as propriedades do Search Console dos meus clientes?
Esse fluxo de parceiro multi-tenant — um Google OAuth por tenant para conectar as propriedades de GSC de todos os clientes na sua própria conta, com isolamento rígido de dados — está em desenvolvimento ativo. Se você está montando uma integração de parceiro, fale com a gente sobre acesso antecipado.
Quais dados eu consigo puxar hoje?
Resumo do Search Console e comparação de períodos, principais palavras-chave e páginas, detalhe de uma palavra-chave ou página, a sua lista de propriedades, prompts do AI Tracker e leitura/escrita completa de tarefas. É o espelho do que o MCP expõe, só que via REST.
Pronto para construir em cima dos seus dados de SEO?
Gere uma chave Bearer no seu dashboard e faça a primeira chamada REST em minutos — ou fale com a gente sobre acesso de parceiro e multi-tenant.
