Visão geral
Uma resposta de API descreve observações com escopo, agrupamento e histórico específicos. Não é uma lista de todos os links da web. Este guia usa o importador local e um exemplo fictício de shop.example. O importador foi testado offline; não houve consulta paga nem medição da cobertura do fornecedor.
Escolha o alvo e preserve a solicitação
O endpoint backlinks/backlinks/live da DataForSEO aceita domínios, subdomínios e páginas. Confira o formato atual na documentação e escolha o escopo adequado. Uma solicitação de página não representa um relatório completo do domínio. Preserve os parâmetros enviados junto com a resposta original para permitir revisão.
O agrupamento muda o significado de uma linha. Os modos documentados incluem as_is, one_per_domain e one_per_anchor. Não compare diretamente relatórios agrupados de formas diferentes. A documentação descreve links únicos por página de referência e links_count para repetições. Uma linha não representa necessariamente cada elemento HTML de link da página. A definição do fornecedor deve prevalecer sobre um rótulo conveniente na planilha.
Planeje acesso e custos antes da coleta
Solicitações ao endpoint live são cobradas. Obtenha autorização, confira preços atuais, defina um limite firme de gastos e armazene respostas úteis em cache. Limitar linhas não basta se um trabalho puder enviar muitas solicitações. Mantenha credenciais no servidor e evite copiá-las em capturas, exportações compartilhadas ou ferramentas públicas do navegador.
O exercício processa localmente uma resposta fornecida e não exige credenciais. Não verifica login, disponibilidade ao vivo, permissões da conta ou completude do índice. Em uma coleta real, registre data, alvo, filtros, agrupamento e paginação e preserve o arquivo original de forma privada.
Confira status e escopo antes das linhas
Verifique tanto a estrutura geral da resposta quanto o status de cada tarefa. Um erro de autenticação ou tarefa não comprova que o alvo tenha zero backlinks. O importador rejeita respostas com falha ou incompatíveis em vez de criar um relatório vazio bem-sucedido. Primeiro identifique e corrija a causa.
Compare o total com os itens retornados. O exemplo fictício indica total 9 e retorna quatro registros; a projeção é explicitamente parcial. São valores demonstrativos, não estatísticas reais. A diferença não significa cinco links perdidos ou quebrados. Coleta adicional exige um plano autorizado e limitado com configurações consistentes.
Reproduza o exemplo local
Use o exemplo fornecido ou baixe seu JSON. Confira alvo shop.example, modo as_is, quatro registros e indicação de resultado parcial. Compare os detalhes com o JSON original antes de baixar o CSV projetado. Também existe uma versão JavaScript para uso offline. Preserve a resposta bruta separadamente: o CSV não mantém todos os campos do fornecedor.
Valores ausentes continuam desconhecidos, sem virar zero ou false. Um anchor ausente difere de um vazio; o campo dofollow do fornecedor é separado da lista de atributos. Uma linha inclui sponsored e nofollow, outra uma observação de perda e outra campos ausentes. Esses casos ajudam a identificar mudanças silenciosas de significado em relatórios posteriores.
Verifique saídas e documente limites
A suíte específica do importador passou em 21 testes em 28 de outubro de 2026. Ela cobre exemplos traduzidos, respostas com falha, limites de tamanho e quantidade, preservação de desconhecidos, URLs incorretas e exportação offline. Isso verifica os casos testados do importador, não cobertura, atualização ou precisão do fornecedor.
Distinga primeira e última observação das datas reais de criação ou remoção. Uma marca de perda não prova remoção permanente, e um status HTTP armazenado pode não ser atual. Uma verificação separada e permitida da página de origem pode investigar o presente. Date separadamente observações do fornecedor, verificações próprias e conclusões. Não deduza posições ou tráfego apenas do número de backlinks.