Usar a API REST do Searvia
Leia rankings, visibilidade em IA, saúde do site, avaliações e dados de mercado nos seus próprios scripts e dashboards, com as mesmas chaves e limites do MCP.
Cerca de 4 minutos
O que você precisa
- Uma chave de API em Configurações › API e MCP
- Qualquer plano: o Free inclui 100 chamadas de API e MCP por mês, o Indie 1.000, o Starter e acima ilimitadas
- 1
Crie uma chave
Conta › API e MCP
Crie uma chave para o script ou servidor que vai chamar a API. Ela funciona apenas na conta em que você estiver ao criá-la.
- 2
Envie como Bearer token
Chame https://searvia.com/api/v1 com o cabeçalho Authorization: Bearer seguido da sua chave. Comece com GET /projects para ver os ids dos seus projetos.
- 3
Escolha endpoints na referência
A página para desenvolvedores lista todos os endpoints; o arquivo OpenAPI em /api/v1/openapi.json traz todos os campos e funciona com Postman, Insomnia e geradores de código.
- 4
Trate páginas, limites e erros
As listas aceitam page e per_page. Acompanhe X-RateLimit-Remaining; em caso de 429, aguarde o Retry-After. Os erros sempre vêm como error.status, error.code e error.message.
O que você recebe
Seus dados fluem para as suas próprias ferramentas, sem copiar do painel.
- Chamadas que usam créditos rodam sem prévia e retornam 402 quando o saldo é insuficiente. Toda alteração feita com uma chave aparece no log de auditoria com o nome da chave.
- Para linhas diárias planas (uma palavra-chave por dia, uma resposta de IA, uma auditoria), use os endpoints de relatório em /projects/{id}/reports.
Solução de problemas e dúvidas
- É o mesmo que o MCP?
- Sim. Cada endpoint executa a mesma ferramenta do servidor MCP, então resultados, limites do plano e créditos são iguais. O MCP é para assistentes de IA; a API REST é para código.
- Uma conexão somente leitura pode alterar dados?
- Não. Apps conectados com acesso somente leitura recebem 403 em endpoints que alteram ou gastam.
Também via MCP:list_projectsget_keyword_rankings