API do Google Search Console para o seu próprio stack
Os dados de desempenho do seu Search Console em um endpoint REST enxuto.
Leve cliques, impressões, CTR e posição média — por consulta, página e intervalo de datas — direto do Google Search Console para o seu produto, dashboard ou data warehouse. Conecte o GSC uma vez dentro da SEOcrawl AI, gere uma chave Bearer no seu dashboard e chame a REST /v1 — sem montar o OAuth do Google. É a mesma camada de dados canônica que alimenta o MCP da SEOcrawl AI, então os seus números sempre fecham. Cobertura de indexação e inspeção de URL chegam na sequência à REST; no MCP já estão no ar hoje.
Resolva uma propriedade. Puxe os dados do GSC.
Gere um token Bearer no seu dashboard e mande no cabeçalho Authorization. Resolva uma vez o id da propriedade do Search Console e depois consulte o desempenho dela via REST. 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_hereTodas as métricas do Search Console via REST
Cliques, impressões, CTR e posição média — por consulta, página, intervalo de datas e período a período. Todo endpoint está amarrado a uma propriedade: resolva o id primeiro e depois leia os dados do Search Console. Esses grupos do GSC já estão ativos na v1; cobertura de indexação e inspeção de URL estão hoje no MCP e chegam na sequência à REST.
Propriedades
Liste as propriedades do Search Console conectadas à sua conta. Use o id de cada uma no caminho de todos os endpoints do GSC.
- GET
/v1/propertiesAtivo
Desempenho
Cliques, impressões, CTR e posição média totais para um intervalo de datas — mais a variação contra o período anterior na mesma janela.
- GET
/v1/properties/{id}/gsc/summaryAtivo - GET
/v1/properties/{id}/gsc/compareAtivo
Consultas
As consultas de busca em que você aparece, com métricas por consulta — e o histórico diário completo de qualquer palavra-chave.
- GET
/v1/properties/{id}/gsc/top-keywordsAtivo - GET
/v1/properties/{id}/gsc/keywords/detailAtivo
Páginas
As URLs que mais performam e as métricas do Search Console de cada uma — com o detalhe diário completo de qualquer página.
- GET
/v1/properties/{id}/gsc/top-pagesAtivo - GET
/v1/properties/{id}/gsc/pages/detailAtivo
Cobertura de indexação
O que o Google indexa de fato: status de cobertura e histórico de indexação. Hoje disponível no MCP; os endpoints REST estão saindo do forno.
- GET
/v1/properties/{id}/indexation/summaryEm breve
Inspeção de URL
Inspeção URL a URL — cobertura, último rastreamento e status de indexação de uma página. Já disponível via MCP; a REST vem na sequência.
- GET
/v1/properties/{id}/url-inspectionEm breve
Dados reais do Search Console, feitos para produto
O seu desempenho real no Google Search Console — não estimativa de terceiro — em uma API REST enxuta, com autenticação Bearer e limite de taxa, dividindo uma única camada de dados canônica com o MCP para que os números nunca divirjam.
Direto do Search Console
Cliques, impressões, CTR e posição média vindos da sua própria propriedade do GSC — os números que o Google reporta, não estimativa modelada nem dado raspado. Recursos previsíveis, verbos padrão, JSON tipado e erros conforme as RFC.
Sem montar o OAuth do Google
Conecte o Search Console uma vez dentro da SEOcrawl AI e leia tudo com uma chave Bearer sca_live_. Esqueça projeto no Google Cloud, tela de consentimento e renovação de token — você cria e revoga chaves no dashboard em segundos.
Uma camada de dados canônica só
Os endpoints REST do GSC e as ferramentas GSC do MCP são irmãos sobre o mesmo provedor, com paridade testada em CI. O seu dashboard e os seus agentes de IA sempre veem os mesmos cliques, impressões e posições.
Granularidade por consulta e por página
Leia os totais de uma propriedade ou desça ao detalhe: principais consultas, principais páginas, a curva diária de uma palavra-chave ou o histórico de uma URL — as mesmas dimensões do Search Console, agora por HTTP.
Comparação de períodos inclusa
Peça um intervalo (last_7_days, last_28_days, last_3_months, last_year) ou datas from/to explícitas e receba a comparação entre períodos já pronta — sem segunda chamada nem conta de data no cliente para bater as variações.
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.
Comece em 3 passos
Do zero à primeira chamada ao Search Console em poucos minutos.
Gere uma chave
Conecte o Search Console na SEOcrawl AI, abra os tokens de API e gere um token Bearer. Copie na hora, porque ele aparece uma vez só — começa com sca_live_.
Resolva uma propriedade
Chame GET /v1/properties com Authorization: Bearer sca_live_… para pegar o id (um UUID) da propriedade do Search Console que você quer ler.
Puxe os dados do GSC
Chame /v1/properties/{id}/gsc/summary?range=last_28_days para os totais, ou /gsc/top-keywords, /gsc/top-pages e os endpoints /detail — e jogue o JSON direto no seu produto, dashboard ou warehouse.
Três caminhos até os seus dados do Search Console
Os mesmos números do GSC, 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 — a API de SEO completa soma endpoints de ranking e de visibilidade em IA com a mesma chave.
Servidor MCP
Para agentes de IA — Claude, ChatGPT e qualquer cliente MCP consultam os seus dados do Search Console em linguagem natural.
Conhecer o MCPTerminal e CLI
Para script e CI/CD — controle os seus dados do GSC de qualquer agente de terminal que fale MCP.
Ver a CLIQuem constrói em cima da API do Search Console
Times que querem dado real de desempenho do GSC dentro dos próprios sistemas.
Agências
Jogue os dados do Search Console 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 do GSC.
SaaS e parceiros
Coloque métricas do Search Console ao vivo dentro da interface do seu produto. Entregue cliques, impressões e posições para os seus usuários sem integrar a API do Google por conta própria.
Times de dados
Leve cliques, impressões, CTR e posição do GSC para o seu warehouse em rotina agendada. Cruze com receita e monte os modelos que os seus dashboards pedem.
Pessoas desenvolvedoras
Automatize o acompanhamento de consultas e páginas, dispare alerta de queda de posição e conecte os dados do Search Console aos apps e fluxos que você já publica.
Perguntas frequentes
Esta é a API oficial do Search Console do Google?
Não. É a API REST da própria SEOcrawl AI, autenticada com Bearer, sobre os dados do Search Console que você já conectou à sua conta. Conecte o GSC uma vez dentro da SEOcrawl AI e a partir daí leia cliques, impressões, CTR e posição com uma chave sca_live_ — sem criar projeto no Google Cloud, sem tela de consentimento OAuth e sem renovação de token. Os números são os seus números reais do Search Console; a API e a autenticação são nossas.
Quais dados do Search Console eu consigo hoje?
Totais para um intervalo de datas (cliques, impressões, CTR, posição média), comparação entre períodos, as suas principais consultas e páginas com métricas e o detalhe diário completo de uma palavra-chave ou de uma página — mais a lista das propriedades conectadas. Cobertura de indexação e inspeção de URL ao vivo já estão no MCP; os endpoints REST chegam na sequência. E se em vez de consultar você quiser ler a conta inteira, a auditoria do Google Search Console cobre os mesmos dados em um prompt só.
Como eu me autentico?
Com um token Bearer. Gere uma chave sca_live_ no seu dashboard e mande em Authorization: Bearer <chave> a cada requisição. Para a sua própria conta não existe fluxo OAuth nenhum — é só o cabeçalho.
Quais intervalos de datas são suportados?
Todo endpoint do GSC aceita um range (last_7_days, last_28_days, last_3_months ou last_year) ou um par from/to explícito. O endpoint gsc/compare devolve essa mesma janela comparada com o período anterior, então você tem as variações sem uma segunda chamada.
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.
É a mesma chave e o mesmo dado do MCP?
É. O mesmo token sca_live_ autentica a API REST e o servidor MCP, e os dois leem de uma camada de dados canônica única — então os números do Search Console que você puxa pela REST são idênticos aos que os seus agentes de IA veem pelo MCP. Uma credencial, duas superfícies.
Pronto para construir em cima dos seus dados do Search Console?
Conecte o GSC uma vez, gere uma chave Bearer no seu dashboard e faça a primeira chamada REST ao Search Console em minutos — ou conheça o MCP para agentes de IA.
