参考
反向链接 API 参考:操作、费用和错误
供监控程序查阅的单页事实:每项操作的费用、分页机制,以及 API 在出错时的行为。

按信用成本分类的操作
| 费用 | 操作 | 备注 |
|---|---|---|
| 免费,无需密钥 | domain、overview、stats、suggest | 适用于仪表板和 DR 检查器 |
| 1 信用点 | bulk_dr、compare、top、dr_distribution、tld_breakdown | bulk_dr 最多支持 2,000 个域名(GET domains= 或 POST body);compare 最多支持 20 个 |
| 2 信用点 | refdomains、backlinks、anchors、toppages、anchor_cloud、intersect | intersect 需要 2 到 10 个域名 |
| 3 信用点 | search、keyword | 对锚文本、标题和 URL 进行全文检索;keyword 查找使用精确锚文本链接的站点 |
认证与状态码
将密钥作为 key= 参数或 bearer 头传递。在解析响应体之前,请先检查 HTTP 状态码。
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esac参数与错误
| 项目 | 值 | 含义 |
|---|---|---|
q | 一个域名 | 查询目标 |
page、per | per 取值范围为 10 到 5000 | 分页;每次调用返回行数上限为 1,000,深度分页上限为 50,000 |
sort、order | order=asc 或 desc | 返回行的排序方式 |
ok | 出现在每个响应中 | 调用是否成功 |
_credits | 仅限已认证响应 | 调用费用及剩余余额 |
| HTTP 401 | 密钥缺失或无效 | 检查密钥或请求头 |
| HTTP 402 | 信用点已耗尽 | 通过 USDT (TRC-20) 充值 |

在调度调用前设计请求
大多数 API 问题源于请求而非响应。SEO 反向链接 API 集成主要是一系列在首次调用前做出的小决策。首先确定密钥、页面大小和排序顺序。
将密钥与脚本分离
将密钥存储在环境变量或密钥库中,不要提交到文件中。将其作为 key 参数或 bearer 头传递。使用请求头可避免密钥出现在容易记录到日志的 URL 中。
不要将生产环境的密钥粘贴到工单或聊天中。如果密钥出现在共享日志中,应视为已泄露。
有意识地选择页面大小
per 参数范围为 10 到 5000,但每次调用最多支持 1,000 行且仅计费一次,因此较大的页面大小意味着更少的计费次数。例如,如果需要 3,400 行,只需四次调用(每次 1,000 行),而不是 340 次调用(每次 10 行)。
保持跨次运行的页面大小一致,以便文件对齐。
固定排序顺序
明确设置 sort 和 order,而不是依赖默认值。相同的参数可确保每周输出具有可比性,因此差异分析能显示真实变化,而非行顺序重新排列。
顺序变化是造成误报的简单原因。
解读数据
数据来自我们自己的链接图谱:181,132,097 个域名、2,774,625,913 个域名间链接以及约 798.5 亿个反向链接。数据每月更新一次。更新频率高于此的数据不会包含在内,因此建议每周轮询一次 seo backlinks api。
DR 的计算公式为 round(100 · log(ref_domains+1) / log(2·10^7))。这是一个对数指标。因此,100 个引荐域名得分为 27,1,000 个得分为 41,10,000 个得分为 55,所以链接数量翻倍仅增加几分。使用 DR 对网站进行排名比较,使用原始计数进行警报,如 严重程度表 所示。
定价为预付费。无订阅,无最低消费。注册赠金为 $100,即 1,000,000 个积分。相比之下,Ahrefs API 单元包含在从 $129/月起售的计划中,提供 200,000 个单元,每次请求至少消耗 50 个单元。
成本规划很简单,只需乘法运算。对单个站点每周调用一次 refdomains 需 2 个积分,乘以 4 周,每月 8 个积分,即 $0.0008。十个站点的成本是此费用的十倍。丢失链接食谱 和 竞争对手任务 仅使用上表中的操作。
无猜测地解读错误
错误代码告诉你谁需要采取行动。按此方式解读。响应将成为路由决策,而非谜团。对于监控器而言,最重要的两个代码是 401 和 402。
401 和 402 是不同的问题
401 表示密钥缺失或错误,在有人修复之前,任何操作都不会成功。402 表示账户积分耗尽,充值即可解决。将它们路由给不同的负责人,以便正确的人看到消息。
将两者发送给人员。静默失败的监控器比从未运行的监控器更糟糕。
先检查状态,再检查正文
先读取 HTTP 状态,再读取 ok 字段。响应可以解析为 JSON 但仍携带失败,因此只有当两者都通过时检查才算完成。每次运行时记录状态,包括成功的运行。
仅重试可恢复的情况
重试 401 会浪费调用,并在日志中填充相同的失败。网络超时则不同。重试少量次数,并在尝试之间暂停,然后停止。
停止并发出警报的运行比隐藏失败直到余额耗尽的重试循环更有用。
每次运行记录状态
每次运行都将 HTTP 状态和余额写入日志,包括成功的运行。当运行在几周后失败时,该行是你首先想要看到的内容。
domain、overview、stats 和 suggest 不需要密钥且免费。在花费单个积分进行付费操作之前,使用它们来验证域名、精确拼写或大致规模。
在将调用放入 cron 之前
- 操作的成本是已知的,并乘以每月运行次数。
- 检查退出代码和 HTTP 状态。
- 402 向人类发送警报。
- 响应按排序保存,因此差异保持清晰。
- 频率匹配每月更新。

关于分页的说明
顺序很重要。对快照使用 per=1000,并保持每周相同的 sort 和 order。如果运行之间的顺序发生变化,差异将显示噪声。这是误报的经典原因。
大型站点?对于拥有超过 1,000 个引荐域名的站点,使用 page=1、page=2 等进行分页。每个页面都是一个单独计费的调用。深度分页上限为 50,000 行,这涵盖了几乎所有普通站点。
关于参考的问题
- 当不确定域名的外观时,我应该首先调用哪个操作?
- 从
overview或domain开始。两者都是免费的,不需要密钥,并显示大致规模和数据的形状。在此之后,仅在refdomains或anchors上花费积分。 - 检查单个域名的完整成本是多少?
- 将每个操作的积分相加,然后乘以运行频率。想象一下对单个域名每周进行一次
refdomains调用、一次anchors调用和一次tld_breakdown调用。每次运行需要 2 + 2 + 1 = 5 个积分,即 $0.0005。四周下来约为 $0.002。 - 为什么同一域名的两个计数不匹配?
- 比较类似项:相同的操作、相同的参数和相同的更新周期。不同操作的计数不可互换,且在更新中途获取的计数可能与一周后获取的计数不同。
- 我如何在不花费积分的情况下测试 cron 作业?
- 首先运行免费操作以检查接线、状态处理和输出格式。然后进行一次付费调用以证明数字,并在测试时将作业限制为单次运行。
- 对于拥有超过 1,000 个引荐域名的站点,分页是否有效?
- 是的。将
page与per一起使用。每个页面都是一个单独计费的调用,深度分页上限为 50,000 行,这涵盖了大多数普通站点。
度过糟糕一周的监控器
监控器在一切都不顺利的日子里赢得信任。在第一次运行之前,计划好响应缓慢、余额变化和结果不完整。这些都是普通事件。每个事件都应在日志中留下清晰的行。
超时和部分拉取
对每次调用设置超时,以便一个缓慢的响应不会使整个作业保持打开状态。如果多页拉取中的某一页失败,记录是哪一页并从中重新启动。这样可避免为已拥有的行支付两次费用。
将部分文件标记为部分,而不是将其保存为正常快照。否则,下一次差异将显示从未发生的丢失。
余额检查
在每个经过身份验证的响应中读取 _credits,并将剩余余额写入日志。一个小脚本可以将其与你选择的底线进行比较,并在下次运行之前发送警告。
假设底线为 500 个积分。每周运行消耗 40 个积分,留有在凌晨 402 到来之前充值的余地。
保持每个作业平淡无奇
为每个作业提供一个文件和一个计划。执行三项操作的 cron 条目可能有三种失败方式,日志可能无法说明发生了哪一种。两个小作业比一个聪明的作业更容易信任。
将计划匹配到更新
将作业的计划匹配到每月更新,而不是时钟。每日运行大多数日子返回相同的文件,这增加了成本和噪声,但未增加信息。每周通常就足够了。