Referência
Verificar backlinks online: ações, custos, parâmetros
Uma referência direta para as chamadas usadas em análise de casos. Os custos são em créditos, e 1 crédito equivale a $0.0001. Cada chamada é cobrada uma única vez, independentemente do número de linhas retornadas.
Ações agrupadas por preço
| Ação | Créditos | Use para |
|---|---|---|
domain, overview, stats, suggest | Grátis, sem chave | Primeira visão de um domínio, sua classificação e números principais |
bulk_dr | 1 | Classifique até 2.000 domínios em uma única chamada (GET domains= ou corpo POST) |
compare | 1 | Coloque até 20 domínios lado a lado |
top, dr_distribution, tld_breakdown | 1 | Veja a estrutura: líderes, a distribuição de classificações e a mistura de TLDs |
refdomains, backlinks | 2 | Liste quem faz link para um site |
anchors, anchor_cloud, toppages | 2 | Leia as palavras usadas e as páginas que atraem links |
intersect | 2 | Encontre referenciadores compartilhados entre 2 a 10 domínios |
search | 3 | Busca de texto completo sobre âncoras, títulos e URLs |
keyword | 3 | Encontre quem está vinculado com uma âncora exata |
Solicite campos, um de cada vez
Seis parâmetros cobrem quase todas as chamadas usadas em análise de casos. Cada entrada descreve o que o parâmetro faz e onde ele termina.
action
Nomeia a chamada, como overview ou intersect. Cada solicitação precisa de uma, e a ação define o preço.
q
O domínio sob exame, escrito sem protocolo, para ações de domínio único como overview e refdomains.
domains
Uma lista separada por vírgulas para ações de múltiplos domínios. intersect aceita de 2 a 10 domínios, compare aceita até 20, e bulk_dr aceita até 2.000 via GET ou em um corpo POST.
key
Sua chave sk_, passada como parâmetro ou como cabeçalho Authorization: Bearer. As ações gratuitas funcionam sem uma chave.
page e per
page navega pelos resultados e per define linhas por página, de 10 a 5000. A paginação profunda para em 50.000 linhas, então refine a pergunta antes de navegar até esse ponto.
sort e order
sort nomeia a coluna e order aceita asc ou desc. Ordenar domínios de referência por classificação ascendente traz os mais fracos para o topo, onde as pegadas tendem a aparecer.
Parâmetros que você reutilizará
A autenticação é um parâmetro key ou um cabeçalho Authorization: Bearer sk_.... Mantenha as chaves fora de URLs que você cola em chats, porque strings de consulta acabam nos logs. O CORS é aberto, então uma ferramenta de navegador funciona tão bem quanto um script. Útil.
A paginação usa page e per, onde per varia de 10 a 5000. Simples. Uma única chamada retorna até 1.000 linhas, e a paginação profunda é limitada a 50.000. A ordenação usa sort mais order=asc ou order=desc.
Coloque a cauda barata primeiro. Ordenar domínios de referência por classificação ascendente coloca os domínios fracos no topo, onde as pegadas aparecem. Esse hábito economiza uma hora.
Mantenha os parâmetros na mesma ordem sempre. Uma ordem fixa facilita a comparação visual de dois endereços salvos e mantém um diff livre de ruído.
Orçamente uma chamada antes de executá-la
O preço segue a ação, não o número de linhas. Essa é a regra. Uma chamada refdomains custa 2 créditos, seja retornando algumas linhas ou uma página inteira. Multiplique o preço pelo número de chamadas que você planeja, não pelas linhas que espera ver.
Escreva o plano antes da primeira chamada. Uma lista curta de ações, domínios e chamadas esperadas é suficiente. Isso transforma uma conta surpresa em uma pergunta. Responda-a cedo.
Por chamada, não por linha
Cada chamada é cobrada uma vez. Navegar por uma lista longa é uma cobrança por página solicitada, então um valor per maior pode reduzir o número de cobranças em uma extração longa. Leia _credits após a primeira página para confirmar o preço antes de continuar. Cada página de uma extração paginada é uma chamada separada, então conte as páginas antes de começar e mantenha per igual em todas.
Defina o custo contra a decisão
Pese o preço de uma resposta contra o que a resposta mudará. Uma verificação de classificação que pode alterar uma compra justifica uma extração paga. Uma curiosidade passageira sobre um concorrente raramente justifica. Mantenha a decisão e os créditos gastos na mesma nota.
Chamadas gratuitas como filtro
Execute domain, overview e stats primeiro. Elas não custam nada e mostram se uma extração paga vale a pena. Imagine um domínio cuja visão geral mostra quase nenhum domínio de referência. Você pode nem precisar de refdomains, e os créditos economizados podem ir para um concorrente. O método de rede usa o mesmo filtro.
O saldo na conta
O saldo fica em _credits em cada chamada com chave. Leia-o após cada execução e copie o valor ao lado do arquivo salvo. Uma chamada que retorna HTTP 402 significa que os créditos acabaram, então recarregue antes da próxima execução.
Respostas e erros
| O que você recebe | Significado | O que fazer |
|---|---|---|
ok em todas as respostas | A flag para testar antes de ler qualquer outra coisa | Rame seu script com base nisso |
_credits em chamadas com chave | Custo desta chamada e seu saldo restante | Registre-o ao lado do documento |
| HTTP 401 | Chave ausente ou incorreta | Verifique o cabeçalho ou o parâmetro key |
| HTTP 402 | Créditos esgotados | Recarregue com USDT (TRC-20) na página da conta |
Como parece uma extração concluída
Uma extração concluída para verificar backlinks online é mais do que um arquivo JSON. Ela carrega uma data, a chamada, a janela e uma nota do que ela não pode mostrar. Mantenha os quatro juntos. Caso contrário, o arquivo perde valor a cada mês.
O corpo bruto
Salve a resposta exatamente como veio, antes de qualquer filtragem ou ordenação. Um resumo que você escreveu pode ser verificado apenas contra o arquivo bruto, então o arquivo bruto é o que deve ser mantido.
Os parâmetros
Registre a ação, o domínio ou lista, os valores de paginação e a ordem de classificação. Duas extrações que diferem apenas em per não são comparáveis até que essa diferença seja anotada.
A janela
Indique o ciclo de atualização do qual os números vieram e o dia em que você os buscou. Um número sem data será contestado com um número mais recente, e a discussão passará a girar em torno da data, não da descoberta.
Os limites
Escreva uma linha sobre o que a chamada não pôde ver: links adicionados após a última atualização, páginas bloqueadas para rastreadores, links atrás de login. A linha mantém uma descoberta de reivindicar mais do que seus dados podem suportar.
Paginação de uma lista longa sem desperdício
A paginação é onde os orçamentos desaparecem silenciosamente. Cada página é outra chamada, e uma lista longa puxada página por página pode custar mais do que a pergunta valia. Dois hábitos mantêm isso honesto.
Ordene antes de paginar
Ordene pela coluna que responde à sua pergunta, depois navegue pelo resultado. A primeira página deve conter as linhas em que você agiria. Se não contiver, altere a ordenação antes de gastar mais chamadas.
Pare quando a pergunta for respondida
Uma lista de dezenas de milhares de linhas raramente é a resposta. Pare de paginar assim que as linhas necessárias estiverem na tela, salve essa página e anote onde você parou. A nota diz ao próximo leitor o que foi deixado de fora. Deixe o resto não lido a menos que a pergunta mude.
Erros em que você pode agir primeiro
Dois códigos de status explicam a maioria das execuções interrompidas. Cada um tem uma correção que leva menos tempo do que adivinhar a causa.
HTTP 401 primeiro, sempre
Um 401 significa que a chave está ausente ou incorreta, então verifique o cabeçalho ou o parâmetro antes de qualquer outra coisa. Copie a chave da página da conta em vez de digitá-la novamente, pois um caractere errado produz o mesmo erro. Se as chamadas gratuitas funcionarem e as pagas falharem, a chave é a causa mais provável, porque as ações gratuitas não precisam de chave.
HTTP 402 no meio de uma execução
Um 402 interrompe uma execução que funcionava há um minuto. Pare o loop, leia o saldo e recarregue antes da próxima chamada. Não tente novamente em um loop apertado, porque cada tentativa é uma solicitação que não pode ser bem-sucedida até que o saldo mude.
Antes de confiar em uma resposta
- Verifique se
oké verdadeiro - Anote a data, porque o índice é atualizado aproximadamente uma vez por mês
- Lembre-se que DR é round(100 · log(ref_domains + 1) / log(2·10^7)), não um número de terceiros
- Compare domínios de referência entre ferramentas, não totais brutos de backlinks
- Arquive o arquivo bruto, não apenas seu resumo
Limites, declarados claramente
Este são dados de links a um preço baixo por chamada. Não rastreia palavras-chave. Também não rastreia classificações. Ahrefs e Semrush são produtos mais completos para isso, e a Ahrefs vende unidades de API dentro de assinaturas a partir de $129 por mês para 200.000 unidades.
Receitas que usam essas chamadas estão em análise de casos com curl, e termos desconhecidos estão no glossário.
Lendo uma resposta com suspeita
Uma resposta é um depoimento. É verdadeiro para o índice no dia do rastreamento, e silencioso sobre tudo fora dele. Pergunte o que o índice não poderia ter visto: páginas bloqueadas por robots.txt, links adicionados após a última atualização, links atrás de login. Se você quiser verificar backlinks online sem escrever código, o verificador na página inicial chama a ação gratuita domain.
Verifique uma coisa manualmente cada vez. Escolha um único referenciador da lista, abra a página e encontre o link. Simples. Se estiver lá, confie um pouco mais no resto. Se não, anote a data e a URL e consulte a tabela de solução de problemas.
Nunca deixe um script agir com base em uma única leitura. Alertar é bom, mas excluir links, enviar arquivos de desavow ou enviar e-mails para proprietores deve esperar por um humano.
