Documentação
Referência de endpoints e preços
Uma URL, muitas ações. Esta é a superfície completa.
Equipe de pesquisa da SEOCheck ·

Ações e custos
| Ação | Créditos | O que retorna |
|---|---|---|
| domínio | grátis | Registro básico e DR para um domínio |
| visão geral | grátis | Resumo do perfil de links de um domínio |
| estatísticas | grátis | Estatísticas em todo o índice |
| sugerir | grátis | Sugestões de domínio conforme você digita |
| bulk_dr | 1 | DR para até 2.000 domínios |
| comparar | 1 | Lado a lado para até 20 domínios |
| top | 1 | Principais domínios |
| dr_distribution | 1 | Distribuição de DR entre domínios que fazem link |
| tld_breakdown | 1 | Links por domínio de nível superior |
| refdomains | 2 | Domínios de referência |
| backlinks | 2 | Backlinks individuais |
| anchors | 2 | Textos ancora |
| toppages | 2 | Páginas mais linkadas |
| anchor_cloud | 2 | Pesos das âncoras |
| intersect | 2 | Linkers compartilhados para 2 a 10 domínios |
| search | 3 | Texto completo sobre âncoras, títulos e URLs |
| keyword | 3 | Quem 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
overviewem um domínio que você conhece. É grátis. - Verifique se sua chave funciona com uma chamada de 1 crédito, como
compare. - Leia
_creditsna 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.
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'
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.

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.
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.
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.
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.
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
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
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.