Como funciona a verificação de backlinks de domínio via API?

Envie o domínio como q para uma ação como overview, refdomains ou backlinks e leia o JSON. As ações gratuitas não precisam de chave. As ações pagas exigem uma chave no cabeçalho bearer ou como key= e custam de 1 a 3 créditos por chamada, independentemente do número de linhas.

Preciso colocar a chave no navegador?

Não, e você não deve. O CORS é aberto, então o navegador pode chamar a API, mas uma chave no código do cliente é pública para todos os visitantes. Mantenha as chamadas pagas no seu servidor e deixe o front-end falar com sua própria rota.

O que acontece quando o crédito acaba?

A API responde HTTP 402. Uma chave ausente ou incorreta retorna HTTP 401. Trate ambos como sinais de parada em vez de tentar novamente. Você recarrega com USDT (TRC-20) na página da conta e a mesma chave continua funcionando.

Quantas linhas são retornadas por chamada?

Até 1.000 linhas por chamada, e cada chamada é cobrada uma vez independentemente das linhas. Pageie com page e per. A paginação profunda é limitada a 50.000 linhas, então para exportações maiores, restrinja a consulta com ordenação ou uma ação diferente.

O DR é o mesmo número do Ahrefs?

Não. DR aqui é nossa própria métrica: round(100 log(ref_domains + 1) / log(2 10^7)). É similar em espírito ao Ahrefs DR ou Moz DA, mas calculado a partir do nosso próprio índice, então compare tendências dentro de uma única ferramenta, não valores entre ferramentas.

Quão frescos são os dados de links?

Aproximadamente um mês. O índice é reconstruído cerca de uma vez por mês, então links recentes podem estar ausentes. Se o seu produto promete alertas diários sobre novos links, você precisa de um fornecedor de rastreamento diário e desta API para os números em massa baratos.

Existe uma taxa mensal ou mínimo?

Sem assinatura e sem mínimo. O crédito é pré-pago: 1 crédito custa $0,0001, então 1.000 chamadas de 1 crédito custam $0,10. Contas novas recebem $100 de crédito grátis, sem necessidade de cartão, apenas com login no Google.

Dados de backlinks em JSON: $100 de crédito grátis, sem cartão, login com Google.

798,5 bilhões de backlinks indexados

Verificação de backlinks de domínio para o seu próprio painel

Um endpoint REST que retorna domínios apontando, âncoras, principais páginas e DR em JSON. Construa sua ferramenta em torno dele, e as primeiras $100 de chamadas são por nossa conta.

Receba $100 grátis Leia o script de DR em massa

Quatro ações não exigem chave
Uma chamada pontua até 2.000 domínios
CORS aberto, chave bearer ou via query-string

GET /api.php?action=domainJSON

$ curl "https://seomasters.dev/api.php?action=overview&q=nytimes.com&key=sk_live_..."

Para que serve

Verificação de backlinks de domínio: quatro endpoints que você vai integrar primeiro

Cada ação recebe o alvo em q e retorna JSON com um flag ok. Escolha conforme a necessidade da sua interface, não pelo que soa mais impressionante.

Consultas gratuitas, sem chave

domain, overview, stats e suggest não têm custo. Use-os para um widget público ou um teste de fumaça no CI.

DR em massa para um portfólio inteiro

bulk_dr pontua até 2.000 domínios por chamada por 1 crédito. Uma única solicitação noturna cobre uma grande lista de clientes.

Domínios apontando e âncoras

refdomains, anchors e backlinks custam 2 créditos por chamada, até 1.000 linhas cada, com page, per, sort e order.

Interseção para tabelas de lacunas

intersect recebe de 2 a 10 domínios e lista quem faz link para eles em conjunto. Dois créditos, independentemente do número de linhas.

Para quem é

O que está por trás do JSON

Os números vêm do nosso próprio crawler e do nosso próprio índice de links: 181.132.097 domínios, 2.774.625.913 links domínio-a-domínio e cerca de 798,5 bilhões de backlinks. Nada é revendido de terceiros.

O índice é atualizado aproximadamente uma vez por mês. Um link colocado na semana passada pode estar ausente, então projete sua interface para mostrar a idade do índice em vez de prometer dados em tempo real.

As respostas autenticadas contêm um objeto _credits com o custo da chamada e seu saldo restante. Registre isso. Sua equipe financeira vai perguntar para onde o gasto foi, e a resposta já está em cada resposta.

Duas páginas valem a leitura antes de escrever código: a referência do campo DR explica o que é a pontuação de 0 a 100, e o guia de proxy para painel mostra onde a chave deve ficar.

A primeira renderização precisa dos números?

Depende de quem lê a página. Uma consulta pública que você quer que os mecanismos de busca indexem deve ter seus números já no HTML. Um painel com login pode buscar suas linhas após o carregamento, embora uma tabela vazia em um celular lento ainda pareça quebrada.

A sugestão padrão é simples: seu servidor chama a API, renderiza as linhas e o navegador apenas ordena e filtra. O guia de proxy mostra essa divisão no Next.js, com o handler de rota incluído.

Para onde vai a chave, mais uma vez

A chave nunca deve estar em uma página que um visitante possa abrir. Mantenha-a em uma variável de ambiente do servidor e faça a chamada a partir do código que roda onde esse segredo vive.

Ferramentas que prometem esconder uma chave no bundle estão escondendo-a de um leitor casual, não de qualquer pessoa com a aba de rede aberta.

Correntes de prata conectando pilares de pedra através de um vale nebuloso representando backlinks de domínio

Uma solicitação, do início ao fim

Substitua pela sua chave. O valor de q é o domínio nu, sem esquema ou caminho.

bash

curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
  -H "Authorization: Bearer sk_live_..."

# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the error

Checklist

Antes do primeiro deploy em produção

A chave vive em uma variável de ambiente do lado do servidor, nunca em um bundle do navegador
Cada resposta é verificada quanto a ok, não apenas o status HTTP
HTTP 401 e 402 não são retryados automaticamente
_credits é escrito no seu próprio log em cada chamada
A UI mostra a atualização mensal, para que ninguém leia os dados como dados em tempo real
A paginação para no limite de 50.000 linhas em vez de looping infinito

Escopo

Uma API de dados de links, não um suite completo de SEO

Pesquisa de palavras-chave, acompanhamento de ranqueamento e rastreamento fresco diário são melhor atendidos pelo Ahrefs ou Semrush. O Ahrefs vende unidades de API dentro de assinaturas a partir de $129 por mês para 200.000 unidades. Esta API precifica dados de links por chamada.

Bom ajuste: painéis, auditorias, pontuação em massa, ferramentas internas
Ajuste fraco: acompanhamento de ranqueamento, volumes de palavras-chave, alertas de links em tempo real
Os dados são atualizados mensalmente, e a documentação diz isso logo no início

Como funciona

Do login a um job noturno

1
Faça login com o Google
A página da conta emite sua chave sk_ e mostra o saldo inicial de $100, 1.000.000 de créditos.
2
Execute uma ação gratuita
Chame overview para um domínio que você conhece bem. Compare a saída com o que você espera antes de construir qualquer coisa.
3
Escreva a camada de fetch
Envolva fetch uma vez: injeção de chave, verificação de ok, log de _credits. Veja as notas de paginação para o loop de paginação.
4
Agende-o
Execute mensalmente para extrações profundas, diariamente para bulk_dr. A tabela de erros cobre o que fazer quando uma noite dá errado.

FAQ

Perguntas que os desenvolvedores fazem primeiro

Como funciona a verificação de backlinks de domínio via API?: Envie o domínio como q para uma ação como overview, refdomains ou backlinks e leia o JSON. As ações gratuitas não precisam de chave. As ações pagas exigem uma chave no cabeçalho bearer ou como key= e custam de 1 a 3 créditos por chamada, independentemente do número de linhas.
Preciso colocar a chave no navegador?: Não, e você não deve. O CORS é aberto, então o navegador pode chamar a API, mas uma chave no código do cliente é pública para todos os visitantes. Mantenha as chamadas pagas no seu servidor e deixe o front-end falar com sua própria rota.
O que acontece quando o crédito acaba?: A API responde HTTP 402. Uma chave ausente ou incorreta retorna HTTP 401. Trate ambos como sinais de parada em vez de tentar novamente. Você recarrega com USDT (TRC-20) na página da conta e a mesma chave continua funcionando.
Quantas linhas são retornadas por chamada?: Até 1.000 linhas por chamada, e cada chamada é cobrada uma vez independentemente das linhas. Pageie com page e per. A paginação profunda é limitada a 50.000 linhas, então para exportações maiores, restrinja a consulta com ordenação ou uma ação diferente.
O DR é o mesmo número do Ahrefs?: Não. DR aqui é nossa própria métrica: round(100 log(ref_domains + 1) / log(2 10^7)). É similar em espírito ao Ahrefs DR ou Moz DA, mas calculado a partir do nosso próprio índice, então compare tendências dentro de uma única ferramenta, não valores entre ferramentas.
Quão frescos são os dados de links?: Aproximadamente um mês. O índice é reconstruído cerca de uma vez por mês, então links recentes podem estar ausentes. Se o seu produto promete alertas diários sobre novos links, você precisa de um fornecedor de rastreamento diário e desta API para os números em massa baratos.
Existe uma taxa mensal ou mínimo?: Sem assinatura e sem mínimo. O crédito é pré-pago: 1 crédito custa $0,0001, então 1.000 chamadas de 1 crédito custam $0,10. Contas novas recebem $100 de crédito grátis, sem necessidade de cartão, apenas com login no Google.