Referência
Campos de pontuação de listagem de ferramentas, um por um
Projete sua tabela de listagens uma vez e a tarefa mensal se escreve sozinha. Aqui está cada coluna de pontuação de link que um diretório pode armazenar, e a chamada que a preenche.
Equipe de pesquisa da SEO Tools AI ·
As colunas, de relance
| Coluna | Preenchido por | Créditos | Atualização |
|---|---|---|---|
| dr | bulk_dr, até 2.000 domínios | 1 | Mensal |
| dr_checked_on | Sua própria tarefa, no dia em que você buscou | 0 | Todas as execuções |
| ref_domains | refdomains, ordenado conforme sua escolha | 2 | Mensal, apenas listagens principais |
| top_anchors | anchors | 2 | Trimestral |
| top_pages | toppages | 2 | Trimestral |
| overview_blob | overview (grátis, sem chave) | 0 | Sob demanda |
| rival_overlap | intersect, 2 a 10 domínios | 2 | Ao adicionar uma ferramenta |
As colunas que merecem seu espaço
Comece com dois. dr é a chave de ordenação, e dr_checked_on é a coluna da honestidade.
Uma pontuação sem data parece um fato, e um mês depois é um boato. A data impede isso, e também permite que sua tarefa pule linhas que foram atualizadas há uma hora após uma falha.
Trate tudo o resto como opcional. Um site de comparação que mostra domínios de referência ao lado da classificação oferece aos leitores um segundo número para verificar cruzadamente, o que é mais útil do que um crachá mais bonito. Nossa ferramenta de análise de backlinks mostra como isso se parece em comparação com outros verificadores.
Associe as colunas ao glossário para que os leitores vejam as mesmas palavras que você usa no back office, e à receita de sincronização quando estiver pronto para preenchê-las.
Colunas para os links que um diretório concede
As pontuações descrevem a ferramenta. Um diretório também concede links, e esses merecem uma coluna própria. Catálogos que pedem um link de volta são comuns, então a pergunta chegará a você mais cedo do que você imagina.
Comece com um campo de sim ou não que registre o link de retorno. Antes de escrevê-lo, verifique o site listado você mesmo, porque uma resposta memorizada é a primeira coisa a dar errado em uma lista de algumas centenas de linhas.
Uma coluna de link recíproco
Adicione reciprocal_link como uma coluna de sim ou não que indica se o site da ferramenta listada faz link de volta para você. Digamos que você mantenha 300 ferramentas e 40 delas tenham pedido um link em troca. Essa coluna mostra quais listagens dependem de um favor, e isso antes que um leitor pergunte.
Mantenha a coluna fora da ordenação de pontuação. Ela descreve o relacionamento, não a ferramenta, então misturá-la em uma classificação tornaria a ordem mais difícil de explicar depois.
Uma coluna de status para links que você publica
Registre outbound_status com o status HTTP de cada link que você publica, além da data em que você o verificou pela última vez. Uma listagem que retorna um 404 é uma promessa quebrada para o leitor, e ninguém mais notará isso por você.
A verificação pode acompanhar a mesma execução mensal de atualização da pontuação. Você adiciona uma coluna e nenhum novo agendamento, que é a manutenção mais barata que um diretório pode comprar.
Registre a promessa que você recebeu
Quando um catálogo pede um link em troca, anote a data, a página e a redação exata da solicitação em uma coluna link_note. Uma nota simples leva um minuto para ser escrita e economiza uma discussão seis meses depois.
Não promova uma colocação que você não possa manter. Se o link de retorno nunca for adicionado, o movimento honesto é marcar a linha e deixar a pontuação de lado.
Mantendo a colocação paga separada
Se uma listagem pagou por sua vaga, armazene um valor placement ao lado da pontuação e nunca deixe a pontuação decidir a ordem sozinha. Um dr alto não deve ser a única razão para uma linha paga ficar acima de uma melhor.
Mostre a marca de pago ao lado da pontuação, para que qualquer pessoa que ordene a página veja ambos. Um leitor que encontra o rótulo é um leitor que continua confiando no resto da lista.
Os parâmetros de solicitação que você realmente usará
Estes são os parâmetros da API, na ordem que uma tarefa de sincronização precisa.
action what to do: domain, overview, bulk_dr, refdomains, anchors ...
q one domain, for single-domain actions
domains comma list, for bulk_dr (GET) or send it as a POST body
key your sk_ key, or use the Authorization: Bearer header
page which page of rows
per rows per page, 10 to 5000, up to 1,000 rows per billed call
sort column to sort by
order asc or descNomenclatura e tipos que envelhecem bem
Nomeie as colunas de acordo com o que elas contêm, não de acordo com um fornecedor. dr está bem para o nosso, mas se você adicionar uma segunda métrica mais tarde, dr_ours e da_moz economizarão uma migração.
Armazene a classificação como um inteiro de 0 a 100, a data como uma string ISO como 2026-10-01, e as contagens como inteiros. Uma coluna de texto que contém 1.2k é uma armadilha para a primeira pessoa que ordená-la.
Mantenha também uma coluna source, com um valor curto como seotoolsai. Custa alguns bytes e responde à pergunta que todo editor futuro fará.
Toda resposta contém ok. As autenticadas também contêm _credits, com o custo dessa chamada e seu saldo restante. Registre ambos. Antes de mapear qualquer outro campo em uma coluna, faça uma chamada domain gratuita e leia o JSON você mesmo.
Configure a tabela em cinco etapas
Nomeie as colunas primeiro
Escreva a lista de colunas antes de tocar em uma chave de API, e nomeie cada coluna de acordo com o que ela contém. Deixe os nomes dos fornecedores de fora dos nomes das colunas, para que uma métrica posterior não force um renomeação.
Faça uma chamada gratuita
Execute overview para um único domínio. Não precisa de chave, então você pode ler o JSON e verificar os nomes dos campos contra sua tabela antes de gastar qualquer crédito.
Adicione a pontuação e sua data
Armazene dr como um inteiro e dr_checked_on como uma data ISO. Essas duas colunas são o mínimo para uma pontuação que um leitor possa confiar.
Teste em vinte linhas
Envie bulk_dr para vinte listagens que você conhece. Compare três resultados manualmente contra a ação domain gratuita, e só então execute a lista completa.
Adicione colunas de detalhes para linhas em destaque
Domínios de referência e âncoras custam 2 créditos por chamada, então busque-os para as listagens que você mostra em detalhes. A pontuação de 1 crédito ainda pode cobrir todas as outras linhas.
Exemplo prático: um registro de listagem hipotético
Este é um exemplo inventado, não uma listagem real. Imagine um diretório chamado ToolShelf com uma listagem para um produto fictício, example-seo.test.
Seu registro contém dr 41, dr_checked_on 2026-10-01 e ref_domains 1.000. Isso se encaixa na fórmula pública, já que log(1001) dividido por log(20.000.000) vezes 100 arredonda para 41.
Um mês depois, a tarefa refaz a busca e encontra 1.800 domínios de referência, então a classificação se torna 45. Apenas dr e a data mudam. O texto da revisão, as capturas de tela e as notas do editor permanecem exatamente como escritas, porque a pontuação não as toca.
Quais listagens merecem uma pontuação, e quão profunda
Nem toda listagem precisa da mesma profundidade. Um diretório com algumas centenas de ferramentas pode pontuar todas as linhas, mas as chamadas de detalhes são uma decisão separada com um custo separado.
Pontue todas as linhas, mesmo as que você esconde dos leitores. Uma listagem oculta ainda precisa de um valor quando alguém filtra o back office, e uma célula em branco lá parece uma verificação ausente, não uma escolha.
Duas listagens em um domínio
Duas listagens podem compartilhar um host, por exemplo, uma ferramenta e sua página de teste gratuito no mesmo site. Uma pontuação pertence a um domínio, então ambas as linhas recebem o mesmo dr.
Adicione uma nota de texto curta como shares domain à segunda linha. Sem isso, um editor vê dois números idênticos e assume que um deles é um erro de cópia.
A mesma regra cobre uma empresa que executa várias ferramentas sob um único site. Cada ferramenta pode merecer sua própria página, mas sua pontuação ainda é a pontuação do domínio em que ela reside, então diga isso na coluna de notas.
Gaste chamadas de detalhes onde os leitores olham
O topo de uma categoria é onde uma contagem de domínios de referência muda uma decisão. Comece as chamadas de 2 créditos aí e deixe a longa cauda em dr sozinha.
Reavalie a divisão uma vez por ano. As listagens sobem e descem na página, e uma linha que estava enterrada em março pode agora merecer a chamada de detalhes.
Mantenha a resposta bruta uma vez
Mantenha o JSON bruto para cada atualização em uma única coluna de texto ou em um arquivo separado. Quando você mudar o que a página mostra, você reconstrói a partir dessa cópia e evita pagar pelas mesmas linhas duas vezes.
Isso também lhe dá um registro para apontar quando uma classificação parece errada. Compare a resposta armazenada com a atual antes de alterar qualquer pontuação manualmente.
Registre o valor ok ao lado da resposta armazenada também. Uma linha construída a partir de uma resposta que não era ok deve ser sinalizada para uma segunda execução, não confiada como uma pontuação.
Execute a atualização em uma ordem fixa
Uma atualização que toca linhas em uma ordem aleatória é difícil de auditar. Processe as linhas na ordem em que aparecem na página, e registre o primeiro e o último domínio da execução no log.
Se a tarefa parar no meio, o log diz onde retomar. Linhas que já carregam a data deste mês podem ser puladas, e nada é pago duas vezes.
Perguntas sobre campos
Devo armazenar o JSON bruto para cada listagem?
Sim, uma vez por atualização. Mantenha-o em uma única coluna de texto ou JSON, então derive dr e os outros campos de exibição a partir dele. Quando você mudar o que mostra, pode reconstruir as páginas sem chamar a API novamente e pagar duas vezes.
O que acontece se um domínio não estiver no índice?
Não adivinhe uma pontuação. Deixe a célula dr vazia e não mostre nenhum crachá para essa listagem. Nosso índice contém 181.132.097 domínios, o que é grande, mas não a web inteira, e um espaço em branco é mais honesto do que um zero.
Preciso de todos esses campos na página pública?
Não. Mostre a classificação e sua data, e talvez domínios de referência para listagens em destaque. Mantenha o resto no back office para ordenação, auditoria e identificação de listagens cujos números saltam entre os meses.