概览

API 响应是在特定范围、分组方式和采集历史下的观察，不是整个互联网的全部链接列表。本指南使用本地导入器和虚构的 shop.example 示例。导入器已离线测试；没有发送付费请求，也没有测量供应商索引的覆盖率。

选择目标并保存请求

DataForSEO 的 backlinks/backlinks/live 支持域名、子域名和具体页面。请在最新官方文档中确认目标格式，并选择能回答实际问题的范围。单个页面的请求不能称为完整域名报告。保存发送的参数及原始响应，方便其他审核者了解当时请求了什么。

分组会改变一行的含义。文档包括 as_is、one_per_domain 和 one_per_anchor。不同分组的报告不应直接当作相同数据比较。文档说明按来源页面返回唯一链接，并通过 links_count 表示重复链接。一行不一定代表该页面中的每一个 HTML 链接元素。解释时应以供应商定义为准，而不是依赖电子表格中方便的列名。

实时采集前规划权限和费用

实时端点按请求收费。连接账户前先取得授权，确认当前价格，设置严格预算上限，并缓存有用响应。如果任务可以连续发送许多请求，单独限制行数并不足以控制支出。凭据应保存在服务器端，不要粘贴到截图、共享导出文件或公开浏览器工具中。

本练习在本地处理已提供的响应，因此不需要账户凭据。它不验证登录、实时可用性、账户权限或索引完整性。以后采集真实数据时，应记录采集日期、目标、筛选条件、分组和分页设置，并私下保存原始文件。团队还应记录谁批准了采集、何时检查预算以及遇到错误时如何停止任务。

分析行之前先检查状态和范围

同时检查响应整体和各任务的状态。认证错误或任务失败不意味着目标有零条反向链接。导入器会拒绝失败响应或不支持的结构，而不是制造一个空的成功报告。先找出并修复原因，再讨论数据含义。

比较总数与实际返回的条目。虚构示例显示总数为 9，返回四条记录，因此明确标记为部分结果。这些只是演示值，不是真实网站统计。不能把差额理解成五条丢失或失效链接；响应仅覆盖一部分记录。继续获取数据时，需要经过授权、有明确限额的计划，并保持设置一致，避免把重叠结果重复累计。

复现本地示例

使用工具提供的示例或可下载 JSON。确认目标为 shop.example、模式为 as_is、返回四条记录，并显示部分结果提示。下载投影后的 CSV 之前，将行详情与原始 JSON 对照。另有可下载的离线 JavaScript 版本。CSV 不能保留供应商所有字段，因此原始响应必须单独保存。

缺失值保持未知，不会自动变为零或 false。anchor 缺失不同于空字符串；供应商的 dofollow 标记也不同于属性列表。例子中，一行带有 sponsored 和 nofollow，另一行包含丢失观察，还有一行存在缺失字段。这些不同情况有助于检查后续表格是否悄悄改变数据含义。共享报告时应说明未知值的表示方法，避免读者误把空白当成否定答案。

保存文件时，可在文件名或独立说明中写明目标、采集日期和请求模式，避免把不同日期或不同范围的结果混在一起。导入失败时，先检查原始文件是否完整、是否属于受支持的响应结构，以及是否存在明确的任务错误；不要为了让图表出现而删除错误信息或手动改成成功状态。若导出给其他团队成员，应说明该 CSV 是原始响应的字段投影，不能替代全部证据。复核某条记录时，仍需返回原始 JSON，查看对应任务和相关字段。

验证输出并说明限制

导入器专项测试于 2026 年 10 月 28 日通过 21 项。测试覆盖各语言示例、失败响应、大小和数量限制、未知值保留、无效网址以及离线导出。它验证的是受测导入器行为，不是供应商的覆盖率、时效性或准确性。测试记录不能用来声称某供应商最好，也不能证明真实账户当前能够正常调用。

首次和最后观察时间不同于链接实际创建或删除时间。丢失标记不能证明永久删除，保存的 HTTP 状态也可能已经过时。可以通过单独且获准的来源页面检查了解当前状态。为供应商观察、自行检查和结论分别记录时间，不要仅凭链接数量推断排名或流量。

如果供应商记录与当前页面不一致，应保留两者的时间和来源，而不是覆盖原始证据。页面可能修改、暂时不可用或依赖渲染；只有实际检查过的部分才能下结论。把无法确认的事项放进待复查清单，并指定负责人和下次检查日期，有助于避免将一次观察误写成永久事实。