参考
Ahrefs 反向链接报告与 API 输出对比：操作参考
如果您习惯于导出 Ahrefs 反向链接报告，此参考将展示您可以从我们的操作中重建哪些部分、每次调用的成本，以及大型套件在哪些方面仍占优势。
操作、价格及其在报告中的对应项
| 操作 | 积分 | 典型报告中的对应部分 | 备注 |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | 标题计数 | 无需密钥 |
| bulk_dr | 1 | 列表的 DR 列 | 每次调用最多 2,000 个域名 |
| compare | 1 | 并排域名对比 | 最多 20 个域名 |
| top, dr_distribution, tld_breakdown | 1 | 摘要图表 | 分布类摘要 |
| refdomains | 2 | 引荐域名标签页 | 分页 |
| backlinks | 2 | 反向链接标签页 | 分页 |
| anchors, anchor_cloud | 2 | 锚文本标签页 | 云图用于展示 |
| toppages | 2 | 按链接数排名的最佳页面 | 吸引链接的页面 |
| intersect | 2 | 链接交集 | 2 到 10 个域名 |
| search, keyword | 3 | 无直接匹配 | 锚文本、标题和 URL 搜索 |
报告标签页如何映射到我们的操作
大多数报告导出以标签页形式呈现，每个标签页在此处都有大致对应的项。并非完全复制。请将此映射视为起点，因为某个标签页中存在的字段在我们的响应中可能根本不存在。
引荐域名标签页
想象一个以按 DR 排序的引荐域名打开的报告。我们最接近的调用是 refdomains，成本为 2 个积分，且可以按相同方式排序。由于行字段名因操作而异，您可能需要在脚本中重命名一两列。
修复跨月排序。按 DR 排序的列表与按流量排序的列表无法进行公平对比，因此请将排序键写入文件名。
锚文本标签页，以及为何云图用于展示
anchors 是用于锚文本标签页的调用，成本为 2 个积分。anchor_cloud 成本相同，但如上方表格所示，它旨在用于展示。如果决策依赖具体数值，请阅读纯文本列表。
阅读锚文本时问一个问题：真正的作者会打出这些词吗？品牌名称和裸 URL 通常没问题。如果大量域名中出现大量重复的相同金钱短语，则不符合要求，应首先检查该部分。
顶级页面及两到十个域名的视图
toppages 是最接近“按链接数排名的最佳页面”标签页的功能。它显示哪些页面吸引链接，当排名变动影响网站的某个文件夹时，这通常比域名总数更能说明问题。
intersect 接受 2 到 10 个域名，每次调用成本为 2 个积分。例如，将您的网站与两个竞争对手进行比较。重叠部分将显示你们三方共享的链接网站，这既简单又便宜。
跨调用适用的参数
三个要素控制所有列表。它们是 page、per 以及 sort 和 order 这一对参数。请在跨月使用时保持固定。
per 接受 10 到 5000 的值，尽管单次调用最多返回 1,000 行，且深层分页上限为 50,000 行。每次调用无论行数多少均计费一次，因此请求整页数据与请求 10 行数据的成本相同。
认证可通过查询中的 key=sk_... 或 Authorization: Bearer sk_... 标头实现。CORS 已开放，但无论何种情况，请将密钥保留在您的服务器上，因为浏览器代码会将密钥暴露给所有访问者。
顺序很重要。当分页浏览结果时，对可能重要的域名按 DR 降序排序，或按升序检查长尾的小型网站。无论选择哪种，请将其记录在文件旁边。
将上方表格视为地图，将已保存的响应视为实地。如果您期望的字段缺失，请基于现有字段构建逻辑。
月度导出，分五步完成
每月执行相同的五个步骤，以便在对比时保存的文件能够对齐。
- 1
选择调用
为每个域名选择
refdomains、anchors和toppages。Overview 和 stats 是免费的，因此将它们添加到同一文件夹中。 - 2
固定深度
设置
page、per、sort和order一次并保持不变。Per 最高可达 5000，但单次调用最多返回 1,000 行。 - 3
保留每条响应不变
在解析之前将原始 JSON 写入磁盘。如果后续脚本失败，保存的副本就是您重新运行的对象。
- 4
读取 _credits 对象
每条经过身份验证的响应都会报告其成本和剩余余额。将两者复制到日志行中，以便在不使用仪表板的情况下查看当月的支出。
- 5
与上月进行比较
对保存的副本进行差异比较。差异配方列出了值得保留的三列。
积分、行数限制和月度账单
价格表很短。账单取决于调用频率和分页方式。其中三个习惯决定了大部分费用。
每次调用收取一次费用，无论行数多少
每次调用只计费一次，因此 per=1000 的成本与 per=10 相同（针对同一操作）。对于需要重复使用的列表，整页是经济的选择；而对于快速查看，则是一种浪费。
假设您每月在同一天为一个域名提取 refdomains。这将消耗 2 个积分，即 $0.0002，按公布的每积分 $0.0001 的费率计算。
50,000 行上限
深度分页在 50,000 行处停止。在此之后继续请求下一页的循环将不会获得新数据，因此在循环开始前应限制页数。
以每次调用 1,000 行达到上限需要五十次调用。每次调用 2 个积分，共计 100 个积分，即 $0.01。成本很低，但前提是脚本应在适当时候停止。
月度习惯的小预算
想象一下十个域名，每个域名的 refdomains 和 anchors 每月提取一次。这将消耗 40 个积分，即 $0.004，从注册时提供的 $100 免费积分（即 1,000,000 个积分）中扣除。
以这种速度，免费积分将使用很长时间，支出日志将显示该速度是否保持。请保持此状态。
响应故障排除
| 您看到 | 原因 | 修复 |
|---|---|---|
| HTTP 401 | 密钥缺失或错误 | 检查密钥和标头拼写 |
| HTTP 402 | 积分已用完 | 在账户页面通过 USDT (TRC-20) 充值 |
| ok 为 false | 请求被拒绝 | 阅读正文中的消息以及您发送的参数 |
| 行数少于大型套件显示的数量 | 索引和抓取时间不同 | 比较趋势，而非总数 |
| 上周建立的链接缺失 | 索引每月重建一次 | 在下一个周期再次检查 |
缺失的行是一个问题，而非答案
两次响应之间消失的行是一个常见的意外。在决定其含义之前，请区分其可能代表的情况。
缺失行背后的三种情况
该链接可能从未被索引，或者已被移除。第三种情况是时间问题：页面在索引重建之前或之后被抓取，该行将在后续周期中出现。
一次调用无法区分这些情况。只有在稍后获取第二个副本，并查看页面本身，才能缩小范围。
在追踪该行之前评估其价值
在任何外联之前，检查域名的 DR 和链接页面。来自弱站点的链接移除通常不会改变计划。来自吸引读者的页面的链接移除可能值得向其所有者发送备注。可疑表显示了缺失行在更广泛原因中的位置。
将导出移至我们的调用
我可以导出 Ahrefs 提供的相同列吗？
不是一一对应。行字段因操作而异，因此请打开保存的响应并自行映射名称。上表为报告的每个部分命名了最接近的操作，但字段名称会有所不同。
API 比 Ahrefs 订阅更便宜吗？
答案取决于调用量。我们公布的价格是每 1,000 次单积分调用 $0.10。Ahrefs 在订阅内出售 API 单位，从每月 $129 起，包含 200,000 个单位，每次请求至少 50 个单位。在决定之前请计算您的调用量。
旧导出仍能与新导出进行比较吗？
仅当排序、深度和来源匹配时。从不同工具在不同周获取的文件是不同的样本。保留旧文件，并以明确标记的配对开始新系列。
我需要将密钥保留在服务器上吗？
是的。CORS 是开放的，因此浏览器可以调用 API，但前端代码中的密钥对每个访问者都是可见的。从服务器发送请求，并从环境变量读取密钥。
在这些调用之上构建报告之前
- 打开每个操作的保存响应，并注意您实际收到的行字段名称。
- 决定文件名中包含哪个月份标签。
- 在月度提取之间保持
page、per、sort和order一致。 - 记录每次经过身份验证的响应的
_credits对象，以便查看每项任务的支出。 - 在脚本中限制深度分页，因为列表在 50,000 行处停止。
- 在您交付的任何报告中添加新鲜度说明，说明索引每月刷新一次。
阅读信封
每条响应都包含 ok。经过身份验证的响应还添加 _credits，以便您记录每项任务的支出并监控余额。
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"