API de SEO

Crie relatórios SEO e automações com JSON estruturado dos seus projetos Screpy. Obtenha evidências de rastreamento, posições de palavras-chave, backlinks, AI Visibility armazenada e resultados de monitoramento por uma API REST por projeto, com ações disponíveis para gerenciar seu trabalho.

Ler o guia de início da API Criar uma conta Screpy

Listar projetos acessíveis

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Trecho ilustrativo de resposta. O acesso REST exige uma conta de membro paga; a chave retorna apenas projetos próprios ou compartilhados aos quais você tem acesso.

Autentique a SEO API

Crie uma chave REST em Configurações → Aplicativos conectados e envie-a como token bearer pelo seu servidor. Escolha as permissões necessárias para a integração.

Chaves somente leitura obtêm dados; chaves de leitura e escrita também permitem alterações compatíveis.
Copie o segredo ao criá-lo: ele aparece uma única vez. Não o exponha em código público do navegador.
Revogue chaves em Aplicativos conectados. São permitidas até 20 chaves ativas, com validade de um ano.

Ler o guia de autenticação

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

Verifique o acesso API

REST exige uma conta de membro paga. A participação no projeto e sua elegibilidade para cada recurso também determinam os registros e ações disponíveis.

Endpoints de conta mostram seu plano, recursos e quantidade de projetos acessíveis.
Relatórios de uso incluem limites dos recursos, mas valores usados e restantes são calculados atualmente apenas para projetos próprios.
Valores de uso null estão indisponíveis; não significam consumo zero.

Ver endpoints de conta

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

Gerencie projetos SEO

Liste projetos próprios e compartilhados, obtenha uma visão geral ou crie projetos dentro da sua cota de projetos próprios. Use os UIDs retornados nas próximas requisições.

Atualize nomes, preferências de mercado e fuso horário e configurações de rastreamento ou monitoramento compatíveis.
Mudar o domínio exige um novo projeto; alterar configurações não reescreve resultados concluídos.
A criação verifica a capacidade e valida o site.
A exclusão é restrita ao proprietário do projeto.

Ver endpoints de projetos

example.comProjeto

example.orgProjeto

example.netProjeto

Inicie rastreamentos do site

Inicie um rastreamento com acesso de escrita e guarde seu UID. Ele roda em segundo plano: acompanhe o status antes de obter os resultados.

Um rastreamento em andamento ou o rastreador desativado pode impedir um novo início.
Resumos e conjuntos de dados exigem um rastreamento concluído com sucesso; resultados inacabados retornam conflito.
Mantenha referências de projeto e rastreamento juntas ao relatar ou comparar registros de um momento específico.

Ver endpoints de rastreamento

1
Revisão/guides
Aberto
2
Gerado/shop
Aberto
Concluídoexample.com
Pendente

Obtenha dados de rastreamento SEO

Crie relatórios de SEO técnico a partir de um rastreamento concluído selecionado. Consulte detalhes das páginas e encontre as páginas de origem dos links e imagens.

As páginas incluem status HTTP, títulos, descrições, cabeçalhos, canonicals, profundidade de rastreamento e tempos.
Registros de links mostram destinos, textos âncora, status nofollow e contexto da página de origem.
Registros de imagens incluem texto alternativo, dimensões, status de obtenção e páginas de origem.
Use filtros de campos compatíveis e registros paginados; não é uma exportação completa de HTML nem uma interface SQL.

Ver endpoints de dados de rastreamento

/guides/seo200

Indexado

Compare projetos e rastreamentos

Compare resumos de SEO técnico entre projetos ou registros de rastreamentos concluídos. Guarde referências explícitas para reproduzir comparações.

Comparações aceitam de dois a cinco projetos acessíveis, com os últimos rastreamentos concluídos ou registros selecionados.
Comparar dois rastreamentos retorna mudanças de saúde, páginas e problemas como segundo valor menos primeiro.
São comparações de resumos; obtenha registros de rastreamento separadamente para investigar URLs individuais.

Ver endpoints de comparação

Antes62→Depois87

Obtenha SEO Quick Wins

Leve oportunidades priorizadas ao seu fluxo com fonte e período do relatório. Uma referência de rastreamento concluído verifica o acesso, mas não transforma toda oportunidade em registro daquele rastreamento.

Com dados conectados disponíveis, Search Console oferece oportunidades sobre consultas próximas das primeiras posições, CTR, canibalização, quedas e mudanças de visibilidade.
Achados de links internos podem usar o rastreamento mais recente do projeto, identificado nos metadados.
Achados derivados do tráfego exigem a conexão correspondente, permissões e dados suficientes.
Preserve tipos de relatório, datas, avisos e disponibilidade; um relatório vazio não prova ausência de problemas.

Conhecer Quick Wins

linen shirt#11

Impressões

2.860

Gerencie o acompanhamento de posições

Leia visibilidade de palavras-chave, histórico de análises e resultados armazenados com seu mercado e dispositivo. Gerencie as palavras acompanhadas em vez de solicitar buscas arbitrárias ao vivo.

Filtre palavras por busca, dispositivo e segmento baseado em URL, incluindo palavras sem correspondência.
Adicione até 100 palavras por requisição; a análise inicial entra na fila, sem resultado imediato.
Exclua palavras acompanhadas e visualize, crie, atualize ou remova segmentos com acesso de escrita.
REST não oferece SERP ao vivo, nova análise manual nem exportação CSV/XLSX do Rank Tracker.

Ver endpoints do Rank Tracker

Classificações

+24 Posição

Acesse AI Visibility

Relacione respostas de IA armazenadas a menções da marca, citações e evidências das fontes. Preserve prompt, país, idioma e plataforma nos seus relatórios.

Leia visões gerais, menções, respostas, citações, prompts acompanhados e atividade de domínios ou URLs de origem.
Adicione até 20 prompts por requisição dentro da capacidade do projeto ou remova prompts acompanhados com acesso de escrita.
Sugestões de prompts, nova análise manual e exportações AI Visibility não são operações REST.

Conhecer AI Visibility

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Analise backlinks

Consulte o perfil de backlinks de um projeto ou de um concorrente já adicionado, escolhido nas opções disponíveis. Relacione links aos domínios de referência para seus relatórios de autoridade.

Obtenha métricas gerais, domínios de referência e backlinks de um domínio selecionado.
Examine lacunas de backlinks e conjuntos compatíveis de domínios perdidos ou com links quebrados.
Preserve alvo, filtros, ordenação e cursor; não é uma consulta irrestrita de qualquer domínio.
Exportações CSV/XLSX de tabelas cobrem a página atual. Continue usando X-Next-Cursor.

Conhecer Backlink Checker

example.org
example.net
example.edu

example.com84 Links

Gerencie registros disavow

Guarde entradas revisadas de domínios ou URLs com notas no projeto e prepare um arquivo de texto no formato Google. As decisões de rejeição são suas.

O acesso de escrita permite adicionar até 100 entradas por requisição ou excluir registros existentes.
Exporte o texto disavow do projeto separadamente das tabelas paginadas.
Revise e envie o arquivo manualmente; salvar um registro não o envia ao Google nem remove um backlink.

Conhecer Disavow Management

disavow.txtRevisão

domain:example.org
https://example.net/links

Domínioexample.org
URLexample.net/links

Consulte a saúde do site

Separe desempenho das páginas e disponibilidade do site nos relatórios. Estes endpoints retornam verificações existentes, não uma nova medição sob demanda.

Desempenho retorna a última página inicial verificada com FCP, LCP, CLS, TTFB, TBT e Speed Index, não todas as páginas nem um histórico completo.
Uptime resume os últimos 30 dias e retorna até as 160 verificações mais recentes com status, tempo de resposta e data.
Sem desempenho, retorna data:null; sem verificações uptime, os valores do resumo ficam null e a lista vazia.

Ver endpoints de saúde

example.comLaboratório

LCP2,1 s
TBT180 ms
CLS0,04

Pagine os dados SEO

Obtenha grandes conjuntos em páginas gerenciáveis e preserve o contexto da requisição no processamento. Verifique a disponibilidade antes de transformar respostas em métricas.

Listas compatíveis retornam 50 registros por padrão e até 100; siga links de continuação ou cursores opacos.
Mantenha filtros, alvos e períodos consistentes entre páginas. Parâmetros inválidos são rejeitados.
Trate explicitamente erros de autorização, rastreamento inacabado, dados indisponíveis e limite de requisições, sem substituir resultados ausentes por zero.

Ler o guia de erros API

JSONcursor_2

Converse sobre API de SEO. Com SEO MCP.

Conecte seu assistente ao projeto Screpy via SEO MCP. Escolha um projeto, revise seu resumo e investigue dados compatíveis de rastreamento, posições e busca com acesso delimitado.

Conheça o Screpy SEO MCP Conecte seu assistente de IA

Perguntas sobre SEO API

Respostas práticas para escolher acesso REST, tratar registros e criar uma integração confiável.

Como SEO API difere de SEO MCP?

SEO API serve ao software que você desenvolve, com requisições REST e uma chave bearer REST. SEO MCP oferece ferramentas compatíveis a assistentes de IA por Model Context Protocol e sua própria autorização. Credenciais MCP não autenticam REST, e as operações disponíveis não são idênticas.

Quais são os limites de requisições API?

Por minuto, o limite base é de 300 requisições por chave e 900 por conta. Endpoints pesados permitem adicionalmente 60 por chave e 180 por conta; os de escrita, 30 e 90. As verificações valem juntas. Trate HTTP 429 e tente novamente após a espera permitida.

Posso exportar dados API como CSV ou Excel?

Endpoints de tabelas de backlinks suportam CSV/XLSX da página atual, com X-Next-Cursor para continuar. O texto disavow tem exportação separada. Exportações CSV/XLSX de Rank Tracker e AI Visibility continuam exclusivas do painel; outras respostas estruturadas podem alimentar seu código de relatórios.

Dados ausentes significam que não há problemas SEO?

Não. Valores null, registros vazios, avisos e erros de disponibilidade têm significados diferentes. Uma verificação de desempenho ausente não é falha do site; uso indisponível não é consumo zero. Verifique a resposta e a configuração antes de concluir.

Todo resultado API é atual ou ao vivo?

Não. Registros de rastreamento pertencem ao momento selecionado; posições e AI Visibility usam análises armazenadas. Quick Wins segue a fonte e o período do relatório. Endpoints de saúde retornam verificações existentes. Preserve datas disponíveis e contexto de origem nos relatórios.

REST oferece todos os recursos do painel?

Não. A referência API lista as operações REST compatíveis. Não há endpoints REST para resultados Map Tracker, geração de artigos, relatórios PDF ou todos os dados analíticos brutos. Rank Tracker e AI Visibility também têm os limites de ações e exportações descritos acima.

Como encontro o UID do projeto e do rastreamento?

Chame GET /projects, selecione um projeto acessível e obtenha sua lista de rastreamentos. Use os UIDs retornados juntos. Endpoints de resumo e dados exigem um rastreamento concluído com sucesso.

Uma chave somente leitura funciona em toda requisição POST?

Não. Comparações POST de projetos e rastreamentos aceitam leitura porque analisam registros existentes. Criar ou alterar registros, iniciar rastreamentos e visualizar segmentos exige leitura e escrita. Verifique o escopo documentado em vez de inferir permissões pelo método HTTP.