Com um token Bearer. Crie uma chave sca_live_ a partir do seu dashboard e envie-a como Authorization: Bearer em cada pedido. Para a sua própria conta não há qualquer fluxo OAuth — apenas o cabeçalho.

API do Search Console · REST v1 · Docs em direto

API do Google Search Console para a sua própria stack

Os dados de desempenho do seu Search Console, através de um endpoint REST limpo.

Traga cliques, impressões, CTR e posição média — por consulta, página e intervalo de datas — diretamente do Google Search Console para o seu produto, dashboard ou data warehouse. Ligue o GSC uma vez dentro da SEOcrawl AI, crie uma chave Bearer no seu dashboard e chame a REST /v1 — sem ter de construir o OAuth da Google. É a mesma camada de dados canónica que alimenta o MCP da SEOcrawl AI, por isso os seus números batem sempre certo. A cobertura de indexação e a inspeção de URL chegam a seguir à REST; via MCP já estão disponíveis hoje.

Obter a sua chave de API Ver a documentação da API Explorar o MCP

API do Google Search Console da SEOcrawl AI — um pedido curl e a resposta JSON tipada com cliques, impressões, CTR e posição.

Exemplos de pedidos à API do Google Search Console em cURL, JavaScript e Python.

Resolva uma propriedade. Extraia os dados de GSC.

Crie um token Bearer a partir do seu dashboard e passe-o no cabeçalho Authorization. Resolva uma vez o id da propriedade do Search Console e consulte depois o seu desempenho via REST. A mesma chave funciona na API REST e no servidor MCP.

URL base

https://api.seocrawl.ai/v1

Cabeçalho Authorization

Authorization: Bearer sca_live_your_token_here

Obter a sua chave de API Read the API docs

Todas 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. Todos os endpoints estão ligados a uma propriedade: resolva primeiro o seu id e leia depois os respetivos dados do Search Console. Estes grupos de GSC já estão ativos na v1; a cobertura de indexação e a inspeção de URL estão hoje no MCP e chegam a seguir à REST.

Propriedades

Liste as propriedades do Search Console ligadas à sua conta. Use o id de cada propriedade no caminho de todos os endpoints de GSC.

GET/v1/propertiesAtivo

Desempenho

Cliques, impressões, CTR e posição média totais para um intervalo de datas — mais a variação face ao período anterior na mesma janela.

GET/v1/properties/{id}/gsc/summaryAtivo
GET/v1/properties/{id}/gsc/compareAtivo

Consultas

As consultas de pesquisa para as quais aparece, com métricas por consulta — e o histórico diário completo de qualquer keyword.

GET/v1/properties/{id}/gsc/top-keywordsAtivo
GET/v1/properties/{id}/gsc/keywords/detailAtivo

Páginas

Os seus URLs com melhor desempenho e as respetivas métricas do Search Console — e 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 a Google indexa realmente: estados de cobertura e histórico de indexação. Hoje disponível no MCP; os endpoints REST estão a ser lançados.

GET/v1/properties/{id}/indexation/summaryEm breve

Inspeção de URL

Inspeção URL a URL — cobertura, último rastreio e estado de indexação de uma única página. Já disponível via MCP; a REST vem a seguir.

GET/v1/properties/{id}/url-inspectionEm breve

Dados reais do Search Console, feitos para produtos

O seu desempenho real no Google Search Console — não estimativas de terceiros — através de uma API REST limpa, com autenticação Bearer e limites de taxa, partilhando uma única camada de dados canónica com o MCP para que os números nunca divirjam.

Diretamente do Search Console

Cliques, impressões, CTR e posição média extraídos da sua própria propriedade de GSC — os números reais que a Google reporta, não estimativas modeladas nem obtidas por scraping. Recursos previsíveis, verbos padrão, JSON tipado e erros conformes com as RFC.

Sem ter de montar o OAuth da Google

Ligue o Search Console uma vez dentro da SEOcrawl AI e leia-o com uma única chave Bearer sca_live_. Dispense o projeto no Google Cloud, o ecrã de consentimento e a renovação de tokens — crie e revogue chaves no seu dashboard em segundos.

Uma única camada de dados canónica

Os endpoints REST de GSC e as ferramentas GSC do MCP são irmãos sobre o mesmo fornecedor, com paridade testada em CI. O seu dashboard e os seus agentes de IA veem sempre cliques, impressões e posições idênticos.

Granularidade por consulta e por página

Leia os totais de uma propriedade ou desça ao detalhe: principais consultas, principais páginas, a tendência diária de uma keyword ou o histórico de um URL — as mesmas dimensões que vê no Search Console, acessíveis via HTTP.

Comparação de períodos incluída

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 logo à partida — sem uma segunda chamada nem cálculos de datas no cliente para reconciliar variações.

Limites de taxa documentados

60 pedidos por minuto e 1.000 por hora por token, com respostas 429 + Retry-After claras. Os limites da REST são um pool separado do uso do MCP — um nunca esgota o outro.

Comece em 3 passos

De zero à sua primeira chamada ao Search Console em poucos minutos.

Crie uma chave

Ligue o Search Console na SEOcrawl AI, abra os tokens de API e gere um token Bearer. Copie-o uma única vez — começa por sca_live_.

Resolva uma propriedade

Chame GET /v1/properties com Authorization: Bearer sca_live_… para obter o id (um UUID) da propriedade do Search Console que quer ler.

Extraia os dados de 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 canalize o JSON diretamente para o seu produto, dashboard ou warehouse.

Três formas de chegar aos seus dados do Search Console

Os mesmos números de GSC, superfície diferente — escolha a que se ajusta à forma como constrói.

API REST

Para produtos, dashboards e pipelines de dados. Autenticação Bearer, JSON tipado, limites de taxa. Está nesta página — a API de SEO completa acrescenta endpoints de ranking e de visibilidade em IA com a mesma chave.

Servidor MCP

Para agentes de IA — o Claude, o ChatGPT e qualquer cliente MCP consultam os seus dados do Search Console em linguagem natural.

Explorar o MCP

Terminal e CLI

Para scripts e CI/CD — controle os seus dados de GSC a partir de qualquer agente de terminal compatível com MCP.

Ver a CLI

Comparar todas as integrações

Quem constrói sobre a API do Search Console

Equipas que querem dados reais de desempenho de GSC dentro dos seus próprios sistemas.

Agências

Canalize os dados do Search Console de cada cliente para um portal personalizado, o Looker Studio ou a sua camada de reporting — uma chave, todas as propriedades, sem exportações manuais de GSC.

SaaS e parceiros

Incorpore métricas do Search Console em direto na interface do seu próprio produto. Ofereça aos seus utilizadores cliques, impressões e posições sem ter de ligar a API da Google por conta própria.

Equipas de dados

Traga cliques, impressões, CTR e posição de GSC para o seu warehouse de forma agendada. Cruze-os com a receita e construa os modelos de que os seus dashboards precisam.

Programadores

Automatize a monitorização de consultas e páginas, alerte para quedas de posições e ligue os dados do Search Console às apps e fluxos que já publica.

Perguntas frequentes

Esta é a API oficial do Search Console da Google?

Não. É a API REST própria da SEOcrawl AI, autenticada com Bearer, sobre os dados do Search Console que já ligou à sua conta. Ligue o GSC uma vez dentro da SEOcrawl AI e a partir daí leia cliques, impressões, CTR e posição com uma única chave sca_live_ — sem criar um projeto no Google Cloud, um ecrã de consentimento OAuth nem uma renovação de tokens. Os números são os seus números reais do Search Console; a API e a autenticação são nossas.

Que dados do Search Console posso obter hoje?

Totais para um intervalo de datas (cliques, impressões, CTR, posição média), comparações entre períodos, as suas principais consultas e páginas com métricas e o detalhe diário completo de uma keyword ou de uma página — além da lista das suas propriedades ligadas. A cobertura de indexação e a inspeção de URL em direto já estão disponíveis via MCP; os respetivos endpoints REST chegam a seguir. E se preferir ler a conta em vez de a consultar, a auditoria do Google Search Console cobre os mesmos dados num único prompt.

Como me autentico?

Com um token Bearer. Crie uma chave sca_live_ a partir do seu dashboard e envie-a como Authorization: Bearer <chave> em cada pedido. Para a sua própria conta não há qualquer fluxo OAuth — apenas o cabeçalho.

Que intervalos de datas são suportados?

Todos os endpoints de GSC aceitam 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, por isso obtém as variações sem uma segunda chamada.

Quais são os limites de taxa?

60 pedidos por minuto e 1.000 por hora por token. Ao ultrapassá-los recebe um 429 com um cabeçalho Retry-After. Os limites da REST são contabilizados separadamente do uso do MCP, por isso os dois nunca competem pelo mesmo orçamento.

É a mesma chave e os mesmos dados do MCP?

Sim. O mesmo token sca_live_ autentica tanto a API REST como o servidor MCP, e ambos leem de uma única camada de dados canónica — por isso os números do Search Console que obtém via REST são idênticos aos que os seus agentes de IA veem através do MCP. Uma credencial, duas superfícies.

Pronto para construir sobre os seus dados do Search Console?

Ligue o GSC uma vez, crie uma chave Bearer a partir do seu dashboard e faça a sua primeira chamada REST ao Search Console em minutos — ou explore o MCP para agentes de IA.

Obter a sua chave de API Ver a documentação da API Agendar uma demo