Pular para o conteúdo
SEO Tools AI
SEO Tools AICadastre-se

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

Os custos são por chamada, não por linha. Uma chamada retorna até 1.000 linhas.
ColunaPreenchido porCréditosAtualização
drbulk_dr, até 2.000 domínios1Mensal
dr_checked_onSua própria tarefa, no dia em que você buscou0Todas as execuções
ref_domainsrefdomains, ordenado conforme sua escolha2Mensal, apenas listagens principais
top_anchorsanchors2Trimestral
top_pagestoppages2Trimestral
overview_bloboverview (grátis, sem chave)0Sob demanda
rival_overlapintersect, 2 a 10 domínios2Ao 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.

text
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 desc

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

Dois campos de resposta dos quais você pode confiar

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

01

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.

02

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.

03

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.

04

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.

05

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.