Pular para o conteúdo
SEOCheck
SEOCheckCadastre-se

Documentação

Referência de endpoints e preços

Uma URL, muitas ações. Esta é a superfície completa.

Equipe de pesquisa da SEOCheck ·

Uma ponte de pedra robusta atravessando um vale nebuloso representando um endpoint de API confiável

Ações e custos

AçãoCréditosO que retorna
domíniográtisRegistro básico e DR para um domínio
visão geralgrátisResumo do perfil de links de um domínio
estatísticasgrátisEstatísticas em todo o índice
sugerirgrátisSugestões de domínio conforme você digita
bulk_dr1DR para até 2.000 domínios
comparar1Lado a lado para até 20 domínios
top1Principais domínios
dr_distribution1Distribuição de DR entre domínios que fazem link
tld_breakdown1Links por domínio de nível superior
refdomains2Domínios de referência
backlinks2Backlinks individuais
anchors2Textos ancora
toppages2Páginas mais linkadas
anchor_cloud2Pesos das âncoras
intersect2Linkers compartilhados para 2 a 10 domínios
search3Texto completo sobre âncoras, títulos e URLs
keyword3Quem está vinculado com uma âncora exata

Autenticação e formato

URL base: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Prefere cabeçalhos? Envie Authorization: Bearer sk_... em vez disso.

Esta API de análise de backlinks responde em JSON e permite chamadas cross-origin, então um navegador pode acessá-la diretamente. Todas as respostas têm um campo ok. As autenticadas também carregam _credits, que contém o custo daquela chamada e seu saldo restante.

Os erros são diretos. HTTP 401 significa que a chave está ausente ou errada. HTTP 402 significa que o saldo acabou. Ambos são fáceis de tratar e nenhum deve ser retryado em loop.

Antes da primeira chamada paga

  • Execute overview em um domínio que você conhece. É grátis.
  • Verifique se sua chave funciona com uma chamada de 1 crédito, como compare.
  • Leia _credits na resposta e confirme se o custo corresponde à tabela acima.
  • Configure um alarme de script para HTTP 402 para que um saldo vazio não falhe silenciosamente.

Paginação e ordenação

Linhas por chamada podem chegar a 1.000. Solicite menos ou mais com per, de 10 a 5000, navegue com page e ordene com sort e order.

bash
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Um jardineiro podando cuidadosamente uma árvore bonsai com tesouras especializadas ilustrando ajustes precisos

Parâmetros que alteram a resposta

Cada ação recebe os mesmos dois básicos, action e q, e depois um conjunto curto de opções. Leia-as primeiro. A maioria dos erros vem de opções que parecem opcionais, mas alteram o custo ou o formato das linhas. Leia as opções antes de copiar uma chamada de um fórum ou blog.

Os exemplos abaixo assumem uma chave no parâmetro key. Substitua o placeholder pelo seu. Mantenha a chave em uma variável de ambiente, não em um arquivo que você faz commit. Cada exemplo nesta referência de API de backlinks usa a mesma URL base.

Paginação com page e per

A opção per define quantas linhas são retornadas, de 10 até 5000. A opção page move você pelo conjunto. Uma chamada que pede 500 linhas e depois page 2 retorna o próximo bloco, não a próxima extração das mesmas linhas.

A paginação profunda para em 50.000 linhas. Se um trabalho precisar de mais que isso, restrinja a consulta com sort ou divida o trabalho por domínio, para que cada chamada permaneça dentro do limite.

Ordenação com sort e order

Ordene no servidor, não no seu script. Pedir sort=dr&order=desc retorna os domínios que fazem link mais fortes primeiro, para que as linhas que importam cheguem na primeira página. Filtrar após um download completo desperdiça tempo e créditos.

Use order=asc quando quiser as linhas mais fracas, por exemplo, para encontrar links finos ou identificar uma queda repentina em um perfil.

Listas: bulk_dr, compare e intersect

As ações de lista aceitam vários domínios em uma chamada. bulk_dr aceita até 2.000 domínios por 1 crédito, com uma string de consulta GET ou um corpo POST. compare aceita até 20 domínios e intersect aceita dois a dez.

Como o preço não depende da contagem de linhas, uma lista longa em uma chamada é mais barata que muitas chamadas curtas. Digamos que você verifique 1.500 sites prospect na segunda-feira. Isso é uma chamada, não 1.500.

Chamadas de busca e keyword custam mais

A ação search executa texto completo sobre âncoras, títulos e URLs. A ação keyword pergunta quem está vinculado com uma âncora exata. Ambas custam três créditos por chamada, então use-as para responder a uma pergunta específica em vez de navegar.

Escolhendo per e page para uma primeira extração

Para uma primeira olhada em um novo domínio, comece com um per pequeno, como 50. Você verá o formato das linhas, os nomes dos campos e o custo em uma resposta curta. Aumente per apenas quando souber que as linhas são o que você precisa. O mesmo hábito funciona para cada ação na tabela acima.

Um erro comum é solicitar 5.000 linhas na primeira tentativa e depois descartar a maioria delas. A resposta é maior, a espera é mais longa e a economia esperada não aparece.

Lendo o medidor de créditos

Toda resposta autenticada termina com _credits, que fornece o custo daquela chamada e seu saldo após ela. Registre. Some no final do mês e você saberá sua conta real até o centavo.

Um orçamento aproximado ajuda. Mil chamadas refdomains custam 2.000 créditos, que são $0,20. Mil chamadas search custam 3.000 créditos, ou $0,30. Uma execução diária bulk_dr em uma lista de 2.000 domínios custa 1 crédito, então cerca de $0,003 por mês.

Em comparação com planos que começam em $129 por mês para 200.000 unidades de API, conforme listados pela Ahrefs, o formato da conta é diferente. Veja a comparação para saber como.

Um par de balanças antigas de latão equilibrando dois pesos distintos representando diferentes tipos de erro

Lendo erros e o campo _credits

Uma resposta pode falhar de duas maneiras diferentes, e seu código deve tratá-las de forma diferente. São problemas diferentes. Uma chave ruim é um problema de configuração. Um saldo vazio é um problema de cobrança. Tratar ambos como um erro genérico oculta qual correção você precisa.

Leia o campo ok primeiro. Depois leia o bloco _credits. Somente depois disso é que você deve olhar as linhas, porque um resultado ausente ou curto é mais fácil de explicar quando você já sabe qual foi o custo da chamada.

Trate 401 e 402 separadamente

HTTP 401 significa que a chave está ausente ou errada. Pare o trabalho e corrija a chave. HTTP 402 significa que o saldo está esgotado. Recarregue na página da conta e continue. Fazer retry de um 401 nunca ajuda, e fazer retry de um 402 sem recarregar também nunca ajuda.

Registre o saldo antes e depois de uma execução

Anote o saldo _credits no início de uma execução e no final. A diferença deve corresponder ao que você esperava das chamadas que fez. Um salto maior significa que um loop executou mais vezes do que você pretendia.

Para uma verificação rápida, multiplique o número de chamadas pelo custo em créditos delas. Se a resposta for 40 e o saldo caiu 4.000, algo está errado com o script, não com a lista de preços.

Verifique as linhas que você pediu

Uma resposta bem-sucedida com menos linhas do que o esperado não é automaticamente um erro. Um domínio pequeno pode simplesmente ter poucos links. Compare a contagem de linhas com o valor per que você enviou e trate uma lacuna como uma pergunta a ser respondida, não uma falha a ser escondida.

Teste as chamadas baratas primeiro

Antes de conectar uma chamada a um trabalho, execute-a uma vez manualmente com as opções menores razoáveis. Verifique a resposta, os nomes dos campos e o valor _credits. Um trabalho que quebra na segunda linha é muito mais difícil de depurar do que uma chamada que falhou na primeira tentativa.

Uma primeira sessão com a API

Quatro chamadas, em ordem, para que cada chamada posterior seja uma que você já entende. Apenas a primeira é gratuita, e isso é intencional.

01

Execute overview em um domínio que você conhece

É grátis e não precisa de chave. Compare o resumo com o que você vê no search console e no próprio site, para saber como parece uma resposta normal.

02

Teste a chave com uma chamada de 1 crédito

Envie compare com seu domínio e um concorrente. Confirme que o campo ok é verdadeiro e que _credits mostra um custo de um crédito.

03

Puxe uma listagem de 2 créditos com um per pequeno

Peça refdomains com per=50 e sort=dr. Verifique se a contagem de linhas e o custo em créditos correspondem à tabela acima.

04

Escreva o custo no seu log

Registre o saldo antes e depois. A partir de agora, todo script que você escrever começará com esse hábito, e uma conta surpresa se tornará uma linha em um log em vez de um mistério.

Preços

Crédito pré-pago. Um crédito é $0,0001. Não há assinatura nem mínimo mensal.

Ações gratuitas

$0

  • domain, overview, stats, suggest
  • Sem necessidade de chave
  • Alimenta o verificador web
Abrir o verificador

Pague conforme o uso

$0.10por 1.000 chamadas de 1 crédito

  • $100 de crédito grátis no cadastro
  • Sem necessidade de cartão
  • Recarregue com USDT (TRC-20)
  • Cobrado uma vez por chamada, não por linha
Receba $100 grátis

Limites que você deve conhecer

O índice cobre 181.132.097 domínios e 2.774.625.913 links de domínio. Ele é atualizado aproximadamente mensalmente. Isso é mais lento que uma raspagem diária.

A paginação profunda para em 50.000 linhas. Para extrações maiores, restrinja a consulta com sort ou divida por domínio.

O login é apenas Google, e os recarregamentos são em USDT. Comece com o verificador de DR, tente uma auditoria de concorrente com o guia de concorrentes ou leia por que algumas equipes abandonam a API da Ahrefs para trabalho puro de link building.

FAQ

Eu pago por linha?

Não. Uma chamada é cobrada uma vez, seja retornando 10 linhas ou 1.000.

O que acontece quando o crédito acaba?

A API retorna HTTP 402. Recarregue com USDT (TRC-20) na página da conta e continue.

Onde encontro minha chave?

No painel após o login com Google.