Separe índice de links e pedidos
Uma API de dados entrega observações de um índice; uma API de pedidos cria ou consulta operações comerciais. Receber registros não publica links, e um recibo não descobre toda a web. O exemplo usa DataForSEO v3 Backlinks Live. O inspetor processa arquivo local sem chave ou chamada paga. Os domínios reservados compõem um exercício fictício, não resultados de uma varredura real.
Valide a resposta antes das linhas
A documentação do endpoint separa resposta, tarefa, requisição e resultados. A ferramenta exige uma tarefa bem-sucedida e um resultado. Erros não equivalem a zero backlinks; sucesso HTTP não basta. Consulte as definições de erros. Guarde destino, filtros e agrupamento. O fornecedor pode consolidar referências da mesma origem, então uma linha não conta necessariamente todas as âncoras físicas.
Leia quatro observações fictícias
O arquivo declara nove resultados e fornece quatro. Os cinco ausentes não estão comprovadamente perdidos. As linhas mostram follow, sponsored/nofollow, perda informada e desconhecidos. Datas são observações históricas do fornecedor. False, zero e ausência permanecem distintos; pares repetidos são preservados. Validar a estrutura JSON não autentica a origem nem prova a veracidade dos dados.
| Controle | Campo ou valor fictício | Interpretação | Não deduzir |
|---|---|---|---|
| Resposta e tarefa | status_code: 20000 nos dois níveis | Estrutura bem-sucedida suportada | Nova verificação da origem |
| Total e recebido | total_count: 9; items_count: 4 | Quatro registros; resultado parcial | Cinco perdas ou inventário completo |
| Origem e destino | url_from; url_to | Preservar par exato | Cada linha conta todas as âncoras |
| Valores tipados | dofollow: false / null | Falso informado e desconhecido diferem | Ausência significa follow |
| Observação histórica | is_lost: true; last_seen: 2026-10-03 | Perda informada pelo fornecedor | Exclusão verificada hoje |
| Contexto da requisição | mode: as_is; backlinks_status_type: all | Guardar escopo junto aos registros | Mesmo total com outro filtro |
Defina limites antes de gastar
Uma integração real precisa de credenciais no servidor, orçamento aprovado e parâmetros registrados. Confira preços e limites atuais e preserve o bruto antes de transformar. A paginação mantém o escopo; compare linhas recebidas ao total e siga as regras do fornecedor. Não repita cegamente uma chamada paga incerta. Uma marca de perda não é uma nova verificação de exclusão. A API Search Console não oferece o relatório Links; linhas de tráfego não o substituem.
Importe localmente e preserve o original
Carregue o exemplo, cole JSON compatível ou selecione arquivo UTF-8. Confira total, linhas, aviso parcial e contexto. CSV serve a tabelas; JSON preserva tipos. Texto vazio e ausente viram células vazias no CSV; textos semelhantes a fórmulas recebem apóstrofo protetor. Baixe módulo, arquivo de linha de comando e exemplo na mesma pasta. Os comandos Node.js abaixo não usam rede. As planilhas CSV são notas de interpretação, não entradas JSON.
Baixar revisão API preenchida · Baixar revisão API vazia
node backlink-api-cli.mjs backlink-api-example-pt.json > backlink-api-records.csv
node backlink-api-cli.mjs backlink-api-example-pt.json --json > backlink-api-projection.jsonRespeite os limites da projeção
São aceitos uma tarefa, um resultado, até 1.000 itens e 512 KiB. Metadados selecionados da requisição têm limite de 2.000 caracteres. Nem todos os campos são exportados; guarde o original. Datas não viram datas de publicação. A ferramenta não busca URLs, une páginas de resultados ou autentica contas. Um resultado vazio válido só descreve seu escopo. Publicação atual, acesso, indexação e desempenho continuam exigindo evidências separadas.