跳过内容
SEO Uptr
SEO Uptr领取 $100 免费额度

参考

反向链接 API 参考:操作、费用和错误

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

石桥横跨河流,一艘小船在下方航行

按信用成本分类的操作

1 信用点 = $0.0001。每次调用按次计费,无论返回行数多少,每次调用最多支持 1,000 行。
费用操作备注
免费,无需密钥domain、overview、stats、suggest适用于仪表板和 DR 检查器
1 信用点bulk_dr、compare、top、dr_distribution、tld_breakdownbulk_dr 最多支持 2,000 个域名(GET domains= 或 POST body);compare 最多支持 20 个
2 信用点refdomains、backlinks、anchors、toppages、anchor_cloud、intersectintersect 需要 2 到 10 个域名
3 信用点search、keyword对锚文本、标题和 URL 进行全文检索;keyword 查找使用精确锚文本链接的站点

认证与状态码

将密钥作为 key= 参数或 bearer 头传递。在解析响应体之前,请先检查 HTTP 状态码。

bash
# 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、perper 取值范围为 10 到 5000分页;每次调用返回行数上限为 1,000,深度分页上限为 50,000
sort、orderorder=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 条目可能有三种失败方式,日志可能无法说明发生了哪一种。两个小作业比一个聪明的作业更容易信任。

将计划匹配到更新

将作业的计划匹配到每月更新,而不是时钟。每日运行大多数日子返回相同的文件,这增加了成本和噪声,但未增加信息。每周通常就足够了。