Pular para o conteúdo
Anchor Social
Anchor SocialCadastre-se

Resolução de problemas

Como verificar backlinks por API quando as linhas parecem erradas

Uma tabela baseada em sintomas para os momentos em que a extração de âncoras retorna menos linhas do que o esperado, custa mais do que o planejado ou diverge dos dados do mês anterior.

Quatro tubos de barro alimentando uma tigela representando erros de dados da API e links bloqueados

Verifique essas três coisas primeiro

A maioria das extrações estranhas remete a uma de três causas. Cada uma pode ser verificada em menos de um minuto, o que torna sensato descartá-las antes que alguém gaste uma hora analisando as linhas. Verifique essas três: a chave, o saldo de créditos ou a data da captura.

Toda resposta autenticada contém ok e um objeto _credits com o custo e o saldo restante, então o primeiro passo é sempre imprimir esses dois campos. Comece por aí, sempre. Se ok for falso, nada sobre as linhas importa ainda.

Em seguida, verifique o mês. Nosso índice é atualizado aproximadamente uma vez por mês, e um link adicionado na semana passada pode simplesmente não estar nele, o que não é um bug.

Mais um hábito. Mantenha uma linha de log por chamada com a ação, o número da página e o saldo restante de _credits; isso facilita rastrear 7 créditos faltantes mais tarde, em vez de ter um mistério no final do mês.

Sintoma, causa, solução

SintomaCausa provávelSolução
HTTP 401Chave ausente ou incorretaEnvie key=sk_... ou Authorization: Bearer sk_...; copie-a novamente da página da conta
HTTP 402Créditos esgotadosRecarregue em USDT (TRC-20) pela página da conta e tente novamente
Menos linhas do que o total sugereUma chamada retorna até 1.000 linhasAdicione page=2, page=3; a paginação profunda para em 50.000 linhas
O custo parece maior que 2 créditosUma ação diferente foi chamadaanchors custa 2 créditos; keyword e search custam 3; verifique o valor de action
O total difere do mês passadoO índice foi atualizadoCompare capturas apenas dentro da mesma ferramenta e ciclo mensal
Um link novo está faltandoO link apareceu após a última atualizaçãoAguarde a próxima atualização mensal; não faça nova extração para rastreá-lo
A participação de marca salta repentinamenteLinks globais adicionaram muitas linhasRecalcule por domínio de link, consulte o guia de execução
Números diferentes do Ahrefs ou SemrushRastreamentos e datas de atualização diferentesEscolha uma fonte para tendências; use a outra para verificações pontuais

Lendo corretamente um resultado curto

Um domínio pequeno pode simplesmente ter poucas âncoras. Um domínio registrado recentemente ou com poucas páginas com links externos pode produzir uma lista curta por motivos perfeitamente comuns. Curto não significa defeito. Nem toda lista curta é uma falha.

Compare a contagem de linhas com as figuras gratuitas do overview para o mesmo domínio: se o overview relatar milhares de backlinks e anchors retornar quarenta linhas na página um, você provavelmente precisa da página dois, não de um ticket de suporte. Se o próprio overview relatar poucas, o domínio é jovem ou pequeno e a extração está correta. Conte primeiro, depois reclame.

O inverso também acontece. Domínios enormes atingem o limite de paginação de 50.000 linhas, então ordene pela coluna que interessa e pegue a fatia superior, ou chame anchor_cloud primeiro para ver quais termos dominam antes de navegar por tudo.

Engrenagens de barro entrelaçadas de tamanhos variados mostrando como as configurações afetam os resultados

Configurações de ordenação e paginação alteram o que você vê

Duas extrações podem diferir por um motivo que nada tem a ver com a web. Ordenação, ordem e tamanho da página atuam juntos, então alterar um deles pode reordenar todo o resultado mesmo quando o domínio e a chave permanecem exatamente os mesmos. A ordenação, a ordem e o tamanho da página decidem quais linhas vêm primeiro e quantas chegam por chamada. Verifique isso primeiro.

Mesmo domínio, líderes diferentes

As primeiras linhas seguem a ordenação solicitada, então um arquivo ordenado de uma maneira não parecerá um arquivo ordenado de outra. A ordenação altera os líderes. Se um arquivo lidera com os maiores domínios de referência e o próximo lidera com as linhas mais recentes, ambos podem estar corretos. Anote a ordenação no nome do arquivo.

Um teste rápido ajuda. Execute-o em um domínio pequeno primeiro, para que o teste custe quase nada e dê uma resposta clara sobre a solicitação. Chame a mesma ação duas vezes com parâmetros idênticos. Se as linhas coincidirem, a diferença está na solicitação, não nos dados.

A página dois não é uma cópia da página um

Cada página é sua própria chamada com sua própria linha de cobrança, e as linhas de uma página não devem se repetir na próxima. As páginas são chamadas separadas. Quando isso acontece, o loop provavelmente manteve o mesmo valor de página. Imprima o primeiro domínio de cada página para confirmar que os números mudam.

Mantenha o número da página no seu log ao lado do saldo. Um loop que trava na página dois é muito mais fácil de corrigir quando você pode ver a chamada exata que parou. Logs economizam horas.

Teste duas páginas primeiro. Um teste curto após as duas primeiras páginas é suficiente. Se a página dois repetir a página um, pare o loop antes que o saldo pague pelas mesmas linhas duas vezes.

Imprima os campos de cobrança antes de qualquer outra coisa

Uma guarda de três linhas que você pode colar em um script cron.

bash
R=$(curl -s "https://anchorsocial.org/api.php?action=anchors&q=example.com&per=1000&key=$KEY")
echo "$R" | jq '{ok, _credits}'
[ "$(echo "$R" | jq -r .ok)" = "true" ] || exit 1

Reparar a ordem quando uma extração parece errada

Trabalhe de cima para baixo. Cada etapa remove uma família de causas antes que a próxima comece.

  1. 1

    Confirme que a chamada foi bem-sucedida

    Leia ok na primeira resposta. Se for falso, as linhas ainda não importam.

  2. 2

    Compare os parâmetros

    Verifique action, q, sort, order, per e page contra o arquivo com o qual você está comparando.

  3. 3

    Verifique a data do índice

    Pergunte se uma atualização mensal ocorreu entre as duas extrações e anote essa data na planilha.

  4. 4

    Reconstrua a solicitação do zero

    Escreva a chamada novamente, parâmetro por parâmetro, para capturar um erro de digitação que uma URL copiada pode esconder.

Sobrescritas de barro sob uma lupa mostrando diferenças sutis para resolução de disputas

Resolvendo uma disputa com o arquivo do mês passado

Quando dois arquivos discordam, a questão raramente é quem está certo. A maioria das discordâncias é causada por uma alteração em uma configuração que ninguém anotou, é por isso que o log importa mais que a memória. É qual parte da solicitação mudou entre eles. Olhe para a solicitação primeiro. Passe por três verificações em ordem, e a maioria das disputas termina na primeira.

Comece com a data do índice

O índice é atualizado aproximadamente uma vez por mês, e essa atualização é a primeira coisa a ser descartada. Um link que entrou no ar após a última atualização não aparecerá em nenhum dos arquivos, e refazer a extração no mesmo dia não corrigirá isso. Datas de atualização explicam lacunas.

Rotule todos os arquivos. Um arquivo nomeado com sua data de extração e seu ciclo de atualização responde à pergunta mais comum antes que alguém precise perguntar em uma reunião. Escreva o ciclo de atualização ao lado de cada nome de arquivo. Então, uma lacuna é lida como uma lacuna no tempo, não como uma lacuna na web.

Mantenha as datas de atualização juntas em uma coluna, não espalhadas em anotações. Um leitor que vê as datas ao lado dos totais raramente precisa fazer uma segunda pergunta. Isso economiza uma pergunta.

Compare o semelhante com o semelhante

Dois arquivos são comparáveis apenas quando a ação, o domínio, a ordenação e o valor de per correspondem. Se a ordenação diferir, as linhas principais diferirão mesmo quando todos os totais coincidirem, e isso pode parecer uma mudança real no perfil. Misturar um arquivo de anchors com um de backlinks é uma maneira comum de inventar uma queda que nunca aconteceu. Configurações correspondentes vêm primeiro.

Se os parâmetros coincidirem e os totais ainda diferirem, essa diferença vale uma análise mais detalhada, e o log diz onde começar. Então, leia o log.

Dê ao valor de per sua própria coluna também, porque ele altera quantas linhas chegam por chamada e, portanto, quantas chamadas uma extração custa. Mantenha-o visível.

Quando as linhas se moveram em vez de desaparecer

Após uma mudança de domínio ou redesign, um link ainda pode existir e apontar para um novo endereço. Hospedadores antigos mantêm links. Compare as páginas principais para o host antigo e o novo antes de chamar o link de perdido. A lista de verificação de migração passa por esse pareamento.

Registre ambos os lados. Registre ambos os endereços em uma linha, para que a mudança permaneça visível na planilha.

Custos que surpreendem as pessoas

Uma conta que cresce mais rápido que o plano geralmente tem uma causa. Muitas equipes percebem uma conta maior apenas no final do mês, então uma visão semanal do total acumulado captura o desvio mais cedo. É a ação. Muitos leitores perguntam como verificar backlinks sem gastar demais, e a resposta começa com o nome da ação. Leia o saldo em cada resposta e mantenha um total acumulado ao lado da sua planilha.

Um saldo que drena mais rápido do que o planejado

Nomes de ação importam. O culpado usual é o nome da ação. anchors custa 2 créditos, enquanto keyword e search custam 3 cada, então um script que mudou de ações elevou silenciosamente a conta. Verifique o valor de action na solicitação antes da primeira execução grande.

Acompanhe o desvio. Mantenha um total acumulado de _credits na planilha. Um pequeno desvio diário é fácil de ver lá, muito antes do final do mês.

Um 402 no meio de um loop

Um 402 significa que o saldo acabou. Pare o loop. Chamadas que já foram servidas foram cobradas, enquanto a próxima falha. Pare o loop, recarregue em USDT (TRC-20) pela página da conta e retome da página em que você parou.

Um ponto de retomada só é útil quando é anotado. Mantenha o número da página no log, para que o reinício não seja um palpite. Anote a página.

Lendo um resultado muito grande

Uma contagem que cresce repentinamente merece uma olhada na fonte antes que se torne uma história. Um único link de modelo pode adicionar milhares de linhas, e uma linha de totais sozinha não dirá se isso é um site ou muitos. As linhas podem estar corretas, e o motivo pode estar em um domínio em vez de em todo o perfil. Verifique a fonte primeiro.

Um rodapé global por trás de uma contagem grande

Um link de modelo que aparece em milhares de páginas de um único site pode explicar um grande bloco de linhas. Agrupe a extração por domínio de link e veja quanto do total um site representa. Agrupe primeiro, depois julgue.

Se um domínio domina, o total é um fato sobre esse site, e a análise deve ser enquadrada dessa maneira. Enquadre-a dessa maneira.

Linhas de um domínio que você nunca vinculou

Âncoras estranhas precisam ser verificadas. Sua presença não prova que algo está errado, mas significa que a linha merece a mesma leitura de qualquer outra linha em sua análise. Domínios de linkagem desconhecidos com âncoras não relacionadas podem vir de um scraper ou uma página comprometida. Abra uma das páginas de linkagem, como um visitante faria, antes de assumir que as linhas pertencem ao seu perfil.

Registre o domínio, a data e a âncora na planilha e mantenha a resposta bruta, para que uma revisão posterior tenha as evidências. Evidências superam a memória.

Se a tabela não resolveu

  • Execute uma ação gratuita como overview para o mesmo domínio; se isso funcionar, o problema é a chave
  • Confirme que você digitou o domínio nu em q, sem caminho
  • Salve o JSON bruto antes de alterar qualquer coisa
  • Verifique o saldo no painel contra _credits
  • Contate-nos pela sua página da conta com a ação e um timestamp

Respostas rápidas

Uma chamada falha custa créditos?

Um 401 ou 402 retorna antes que qualquer linha seja servida. Cada chamada bem-sucedida é cobrada uma vez, independentemente da contagem de linhas até 1.000 linhas. Verifique _credits na resposta para confirmar quanto uma determinada chamada custou.

Por que duas extrações no mesmo dia difeririam?

Não deveriam, porque o índice só muda em sua atualização mensal. Se diferirem, compare primeiro os parâmetros de ordenação e página, depois sua chave e a ação. A página do verificador gratuito cobre o que as chamadas sem chave retornam.