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

API REST · v1 · Docs em direto

API de SEO para a sua própria stack

Os seus dados de SEO e de visibilidade em IA, através de um endpoint REST limpo.

Traga dados do Google Search Console, de ranking e do AI Tracker diretamente para o seu produto, dashboard ou data warehouse. Autentique-se 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 de auditoria de site e OAuth de parceiros multi-tenant estão a chegar a seguir.

Obter a sua chave de API Explorar o MCP

Autenticação Bearer · 60 req/min · Mesma camada de dados do MCP · Sem scraping

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

"metrics_diff": { "clicks": 584, … }

} }

Autentique-se uma vez. Chame a REST.

Crie um token Bearer a partir do seu dashboard e passe-o no cabeçalho Authorization. A mesma chave funciona tanto na API REST como 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

cURLJavaScriptPython

# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())

Endpoints

Uma camada de dados, duas superfícies

Cada endpoint REST lê da mesma camada canónica que as ferramentas do MCP — para que o seu dashboard e os seus agentes de IA vejam sempre números idênticos. Estes grupos estão disponíveis na v1; mais cobertura chega continuamente.

Propriedades

Liste as propriedades do Search Console a que tem acesso. Use o `id` de cada propriedade 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.

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 monitoriza para menções à marca no ChatGPT, Claude, Gemini e Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsAtivo

Tarefas

Leia e escreva tarefas de SEO — ligue o seu quadro de tarefas à sua própria stack de gestão de projetos.

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, referenciadores de IA e estado de indexação. A ligação está pronta; os endpoints REST estão a chegar.

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

Auditoria de site

Saúde do rastreio, on-page, técnico e listas de problemas — o conjunto completo de dados da auditoria, exposto via REST.

GET/v1/properties/{id}/audit/summaryEm breve
GET/v1/properties/{id}/audit/issuesEm breve

Porquê esta API

Construída para produtos, não para scrapers

Uma verdadeira API REST com autenticação Bearer, scopes e limites de taxa — partilhando uma camada de dados canónica com o MCP, para que os números nunca divirjam.

REST limpa, JSON tipado

Recursos previsíveis, verbos padrão, respostas JSON tipadas e erros conformes com as RFC (401 não autenticado, 403 scope_required, 429 com Retry-After). Sem scraping de HTML, sem exportações frágeis.

Uma camada de dados canónica

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

Chaves self-service

Crie e revogue tokens Bearer a partir do seu dashboard em segundos. A mesma chave sca_live_ autentica tanto a API REST como o servidor MCP — uma credencial, duas superfícies.

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.

Acesso por scopes

Scopes de leitura e escrita gerais protegem cada endpoint, aplicados na firewall com respostas de step-up padrão. Conceda a uma chave apenas o que ela precisa.

Multi-tenant, a chegar

Um fluxo Google OAuth por tenant para que os parceiros possam ligar cada uma das propriedades de GSC dos seus clientes numa só conta — com isolamento rigoroso de dados. Em desenvolvimento ativo; peça-nos acesso antecipado.

Comece em 3 passos

De zero à sua primeira chamada autenticada em poucos minutos.

Crie uma chave

Abra os tokens de API no seu dashboard e gere um token Bearer. Copie-o uma vez — começa por `sca_live_`.

Envie o cabeçalho

Passe `Authorization: Bearer sca_live_…` em cada pedido a `https://api.seocrawl.ai/v1`. A mesma chave também funciona com o servidor MCP.

Extraia dados

Chame `GET /v1/properties` para obter um `id` de propriedade e depois aceda a `/v1/properties/{id}/…` para desempenho do GSC, prompts do AI Tracker ou tarefas — e canalize o JSON diretamente para o seu produto, dashboard ou warehouse.

Três formas de chegar aos seus dados

Os mesmos números, 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.

Servidor MCP

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

Explorar o MCP

Terminal e CLI

Para scripts e CI/CD — controle os seus dados 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

Equipas que querem dados de SEO e de visibilidade em IA dentro dos seus próprios sistemas.

SaaS e parceiros

Incorpore métricas de SEO em direto na interface do seu próprio produto. Ofereça aos seus utilizadores dados do Search Console e de visibilidade em IA sem construir as pipelines por conta própria.

Agências

Canalize os dados 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.

Equipas de dados

Traga dados de GSC, de ranking e do AI Tracker para o seu warehouse de forma agendada. Cruze-os com a receita e construa os modelos de que os seus dashboards precisam.

Programadores

Automatize verificações e alertas, sincronize tarefas com a sua ferramenta de PM e integre a monitorização de visibilidade em IA nas apps que já publica.

Perguntas frequentes

Existe mesmo uma API de SEO pública?

Sim — uma API REST `/v1` autenticada com Bearer está ativa, cobrindo o desempenho do Search Console, propriedades, prompts do AI Tracker e tarefas, com a referência pública completa publicada em api.seocrawl.ai/docs. Cobertura mais ampla (GA4, exportação completa de auditoria de site) e OAuth de parceiros multi-tenant estão a chegar a seguir. Precisa de algo que ainda não está ativo? Peça-nos acesso antecipado.

Como me autentico?

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

É a mesma chave do MCP?

Sim. O mesmo token autentica tanto a API REST como o servidor MCP, porque ambos leem de uma camada de dados canónica. Uma credencial, duas superfícies — e números idênticos entre elas.

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.

Posso ligar as propriedades do Search Console dos meus clientes?

Esse fluxo de parceiros multi-tenant — um Google OAuth por tenant para poder ligar cada uma das propriedades de GSC dos seus clientes na sua própria conta, com isolamento rigoroso de dados — está em desenvolvimento ativo. Se está a construir uma integração de parceiro, contacte-nos para acesso antecipado.

Que dados posso extrair hoje?

Resumo do Search Console e comparações de períodos, principais keywords e páginas, detalhe de uma única keyword/página, a sua lista de propriedades, prompts do AI Tracker e leitura/escrita completa de tarefas. Espelha o que o MCP expõe, via REST.

Pronto para construir sobre os seus dados de SEO?

Crie uma chave Bearer a partir do seu dashboard e faça a sua primeira chamada REST em minutos — ou fale connosco sobre acesso de parceiro e multi-tenant.

Obter a sua chave de API Agendar uma demo