Guia de configuração

Encontre minha lista de backlinks e configure um monitoramento mensal

Dez minutos de configuração fornecem um registro datado de quem faz link para você. Quando surgirem problemas, você compara dois arquivos em vez de adivinhar.

Equipe de pesquisa DarkSEO · Atualizado 2026-10-28

Configuração em seis etapas

Faça login com o Google

Use a página da conta para fazer login. Contas novas recebem $100 de crédito, sem necessidade de cartão.

Crie uma chave de API

A chave começa com sk_. Mantenha-a fora de repositórios públicos; trate-a como uma senha.

Experimente a consulta gratuita

action=overview&q=yourdomain.com não custa nada e confirma sua chave e a grafia do domínio.

Puxe as listas reais

Execute refdomains, anchors e toppages, 1.000 linhas por chamada, 2 créditos cada.

Salve com a data

Nomeie os arquivos como refdomains-2026-10.json. Nunca substitua o arquivo do mês anterior.

Diff

Compare as linhas com as do mês anterior. Os domínios novos são o que você deve ler.

Uma chamada, com todos os campos explicados

Substitua o domínio e a chave. O mesmo padrão funciona para todas as ações.

bash

curl "https://darkseo.net/api.php?action=refdomains&q=yourdomain.com&per=1000&page=1&key=sk_live_..." \
  -o refdomains-2026-10.json

Referência de parâmetros

Parâmetro	Significado	Notas
action	Qual relatório executar	refdomains, backlinks, anchors, toppages e outros
q	O domínio que você está investigando	Domínio nu, sem protocolo
key	Sua chave de API	Ou envie Authorization: Bearer sk_...
page	Número da página	A paginação profunda é limitada a 50.000 linhas
per	Linhas por página	De 10 a 5000; a cobrança é feita uma vez por chamada
sort, order	Coluna de ordenação e asc ou desc	Útil para ver os mais recentes ou maiores primeiro

Nomeação, armazenamento e comparação dos arquivos

Encontrar minha lista de backlinks só ajuda se os arquivos puderem ser comparados sem ajuda. Uma regra clara de nomeação e uma pasta por mês fazem a maior parte do trabalho. Gaste dez minutos definindo a regra agora, porque uma hora de organização depois é pior. Depois, nunca renomeie os arquivos.

Use o mesmo padrão para todos os domínios e todas as chamadas, para que uma ordenação simples organize os arquivos por mês. Padrões misturados quebram a ordenação, e uma ordenação quebrada é como o arquivo do mês anterior acaba sendo substituído.

Nomes de arquivos que ordenam

Coloque o ano e o mês primeiro, depois o domínio e o nome da chamada, como 2026-10 seguido pelo domínio e refdomains. Meses com zeros à esquerda ordenam corretamente, e um nome nessa ordem lê-se como um log.

Evite espaços e caracteres acentuados nos nomes. Scripts lidam mal com eles, e uma falha na cópia pode parecer uma cópia bem-sucedida.

Uma pasta por mês

Crie uma pasta para cada mês e copie os três arquivos para cada domínio nela. Uma pasta por mês mantém o mês anterior intacto, de modo que um diff se torna uma comparação entre duas pastas.

Marque a pasta como somente leitura quando o mês for encerrado, se seu sistema permitir. Um arquivo salvo que não pode ser editado é um registro muito mais forte.

Um changelog curto

Mantenha um log em texto puro na pasta raiz. Escreva uma linha por extração com a data, os domínios e as chamadas realizadas. Um changelog permite que você explique uma lacuna na série anos depois, quando ninguém mais lembra o motivo.

Adicione o custo em créditos de cada resposta à mesma linha, para que o log sirva também como fatura.

Registre toda alteração na lista de domínios no mesmo log, com o motivo. Um domínio adicionado em um mês explica um salto naquele mês e economiza uma busca longa depois. Mantenha as linhas em texto puro, para que um script possa ler o log se você quiser um resumo automático.

Erros e correções

Erro	Sintoma	Correção
Chave ausente ou incorreta	HTTP 401	Verifique a chave e a grafia do cabeçalho
Saldo vazio	HTTP 402	Recarregue com USDT (TRC-20) na página da conta
Leitura de `ok` ignorada	Arquivo vazio tratado como sucesso	Teste o flag ok no seu script antes de salvar
Substituindo o mês anterior	Nenhum diff possível	Coloque o mês no nome do arquivo
Esperando dados em tempo real	Link novo ausente	O índice é atualizado aproximadamente uma vez por mês; compare mensalmente, não diariamente

Automatizando

Uma entrada cron no primeiro dia do mês é suficiente. Escreva as três chamadas curl em um único script shell, adicione o mês a cada nome de arquivo e deixe-o enviar um e-mail para você apenas quando a contagem de domínios novos ultrapassar seu limite.

As respostas autenticadas incluem _credits com o custo e o saldo restante, para que o script possa avisar você antes que o saldo fique baixo. Teste-o uma vez manualmente. Depois, esqueça-o até o e-mail chegar.

Para uma equipe, combine a extração mensal com os limites de exemplo, para que todos leiam a mesma regra.

Mantenha o script simples. curl puro, um loop sobre seus domínios, uma pasta por mês. Scripts simples sobrevivem a mudanças de equipe.

Lidando com uma execução falha

Uma execução falha deve deixar os arquivos do mês anterior intactos e escrever uma linha no changelog. A armadilha comum é um download parcial: um arquivo que existe mas contém um corpo de erro parece dados à primeira vista. Verifique o tamanho e o flag ok antes de movê-lo. Nada chega à pasta mensal sem verificação.

Se a execução falhar duas vezes seguidas, verifique a chave e a grafia do domínio primeiro. A consulta gratuita de overview testa ambos sem custo, então uma falha ali indica se o problema é a configuração ou a chamada paga.

Mantendo o monitoramento dentro de um orçamento

Um monitoramento é barato quando você conhece a matemática. Cada chamada paga é cobrada uma vez, independentemente do número de linhas, até 1.000 linhas por chamada. Multiplique as chamadas que você faz pelo custo em créditos e depois por $0,0001 por crédito, e você terá a fatura mensal. Faça isso primeiro.

Aqui está a matemática para três chamadas em um domínio. refdomains, anchors e toppages custam 2 créditos cada, totalizando seis créditos, o que dá $0,0006 por mês.

Estimando a fatura mensal

Adicione uma chamada bulk_dr para os novos entrantes com 1 crédito, e o total aumenta mais um crédito. A tabela na página de limites calcula o caso de dez sites, para que você possa ver como os valores crescem com a lista.

Mantenha a estimativa no mesmo log das extrações. Uma fatura que aumenta gradualmente é mais fácil de explicar quando a estimativa foi escrita primeiro.

Parando antes que o saldo acabe

As respostas autenticadas incluem o custo e o saldo restante. Leia-as no script, compare o saldo com a estimativa do próximo mês e avise-se quando a margem estiver fina. Uma resposta com ok definido como false deve interromper a execução antes que qualquer arquivo seja salvo.

Um HTTP 402 significa que o saldo acabou. Recarregue com USDT (TRC-20) na página da conta, depois execute novamente as chamadas daquele mês em vez de pular o mês.

Um loop mensal

Um esboço, não um produto. Ele salva três relatórios por domínio com o mês no nome. Ajuste a lista e a chave.

bash

#!/bin/bash
M=$(date +%Y-%m)
for D in yourdomain.com second-site.org; do
  for A in refdomains anchors toppages; do
    curl -s "https://darkseo.net/api.php?action=$A&q=$D&per=1000&key=$DARKSEO_KEY" -o "$D-$A-$M.json"
  done
done

O que fazer com os arquivos

Abra os arquivos refdomains do mês anterior e deste mês lado a lado e liste os domínios que estão apenas no novo. Essa lista é sua leitura do mês.

Envie a lista para bulk_dr para uma pontuação rápida de qualidade, verifique o arquivo de anchors para qualquer frase que cresceu e leia as páginas principais para URLs que você não reconhece. Se tudo parecer normal, escreva uma linha no seu log e feche a aba.

Se algo parecer errado, abra o runbook e a tabela de decisão de desavow. A extração mensal custa uma fração de centavo, então o custo real é sua atenção.

Escrevendo a nota mensal

Escreva uma nota curta no final de cada mês. Nomeie os domínios, a contagem de domínios novos, a maior participação de anchor e a decisão. Quatro linhas são suficientes. Uma nota escrita no mesmo dia vale mais do que uma longa escrita depois.

Mantenha a nota junto aos arquivos, não dentro deles. Um leitor futuro deve encontrar a decisão em um só lugar, com os números que a justificaram. Esse leitor pode ser você, um ano depois, sem memória do mês.

Perguntas sobre o monitoramento mensal

Preciso de um plano pago para executar isso?

Não há assinatura nem mínimo mensal, porque o serviço é baseado em crédito pré-pago. Contas novas recebem $100 de crédito gratuito sem necessidade de cartão. As consultas gratuitas não custam nada, então você pode testar a configuração antes de puxar qualquer lista paga.

Por que não executar o script todos os dias?

O índice é atualizado aproximadamente uma vez por mês, então um trabalho diário baixaria a mesma imagem repetidamente. Execuções diárias também gastam créditos sem novas informações. Mensal é o ritmo honesto para esses dados.

O que devo fazer se o arquivo novo for muito maior?

Verifique a contagem de linhas em relação à sua linha de base, depois abra os novos entrantes no diff. Um arquivo maior pode vir de um pico real ou de um limite de linhas alterado. Elimine a segunda causa primeiro, porque é a verificação mais barata.

Um script pode monitorar vários domínios?

Sim. O loop mensal acima lida com uma lista de domínios, e cada um recebe seus próprios arquivos. Mantenha a lista curta o suficiente para que cada domínio receba uma leitura real a cada mês, porque um monitoramento que ninguém lê é apenas um custo de armazenamento.

Dois limites para lembrar

O índice é atualizado aproximadamente uma vez por mês, então um trabalho cron diário apenas baixaria a mesma imagem. E uma lista de links não é um veredito: combine cada sinalização com o relatório de links do Search Console antes de agir.