How do I check website backlinks with a script?

Send a GET request to the refdomains or backlinks action with the target domain in q and your key in key. You get JSON back, 1,000 rows at most per call, billed at 2 credits. Loop on page until you reach total.

Is there a free way to find backlinks?

Partly. The overview, stats, domain and suggest actions are free and need no key. Row-level lists such as refdomains and backlinks cost 2 credits, which the $100 sign-up credit covers many thousands of times over.

它可以在 GitHub Actions 或 cron 上运行吗？

可以。它是一个带有标头或查询字符串中密钥的 HTTPS GET 请求，因此计划工作流、crontab 行或 systemd 计时器均可使用。将密钥存储为密钥，不要放在仓库中。

数据是否实时更新？

不。我们的爬虫大约每月刷新一次索引，因此最新的链接可能缺失。每小时轮询没有帮助；每周或每月运行与数据匹配。实时神话页面解释了如何与之配合使用。

积分用完时会发生什么？

API 返回 HTTP 402。您的脚本应停止并报警，而不是重试。从账户页面使用 USDT (TRC-20) 充值，下一次运行将从相同的余额继续。

价格与 Ahrefs API 单位相比如何？

Ahrefs 在订阅中出售 API 单位，每月 $129 起，提供 200,000 个单位，每次请求至少 50 个单位。这里每次调用需要 1 到 3 个积分，每 1,000 次调用 $0.10 起，没有月度最低消费。

响应使用哪种格式？

JSON，始终如此。每个响应都带有 ok 标志，经过身份验证的响应还会添加 _credits，其中包含调用成本和您的剩余余额，这使得支出易于记录。

索引每月刷新

通过脚本检查网站反向链接，而非仪表板

Linkzoid 是一个用于反向链接、引用域名、锚文本和 DR 的纯 REST API。你可以从 Python、cron 或 GitHub Actions 调用它，并将输出保留在你自己的文件中。

免费获取 $100 查看 Actions 运行手册

HTTPS 上的 JSON，CORS 已开放
概览、统计和域名调用无需密钥
每 1,000 次调用起价 $0.10，无订阅

GET /api.php?action=domainJSON

$ curl "https://linkzoid.pro/api.php?action=overview&q=nytimes.com&key=sk_live_..."

用途

四个无需打开浏览器即可检查网站反向链接的任务

这些都是人们已经保存在仓库中的脚本。API 仅提供数据。

你个人资料的每周快照

计划工作流提取引用域名和锚文本，写入带日期的文件，并在出现异常时发出明显错误。运行手册包含 YAML。

从竞争对手列表进行潜在客户挖掘

交叉分析两个到十个域名，剔除已有部分，批量评分其余部分。食谱约四十行代码。

将个人资料与上个月进行差异比较

将每次运行存储到 SQLite 中，并查询哪些域名出现或消失。差异页面添加了阈值表以发现潜在问题。

取代手动导出习惯

如果团队成员每月下载 CSV，脚本可以完成此工作。在切换之前，将其与套件报告进行比较。

其局限性

链接数据，而非关键词套件

我们涵盖反向链接、引用域名、锚文本、顶级页面和 DR。排名追踪、关键词研究和每日新鲜抓取不在这里，Ahrefs 或 Semrush 在这些方面做得更好。

我们自己的爬虫每月刷新索引约一次
上周添加的链接可能尚未显示
DR 是我们自己的 0-100 对数度量指标，而非 Ahrefs DR 或 Moz DA

适用对象

典型运行的样子

这里的脚本大多很枯燥。这正是重点。作业读取域名列表，调用 API，检查 ok 是否为 true，然后写入文件。

免费操作（domain、overview、stats、suggest）不需要密钥，因此你可以在花费任何资金之前测试解析器。先测试。付费调用成本为 1 到 3 个信用点，1 个信用点等于 $0.0001。无论返回多少行，每次调用只计费一次，每次调用最多 1,000 行。

错误很明确。401 表示密钥缺失或错误，402 表示信用点耗尽。这两种情况都不值得重试循环。

登录使用 Google 账户，$100 启动信用额度无需信用卡。简单。当信用点用尽时，可以通过账户页面使用 TRC-20 上的 USDT 充值。如果你更愿意将其集成到可视化构建器中，请先权衡选项。

保持第一个脚本小巧

第一个脚本应只做一件事：获取行，检查 ok 并写入文件。在手动运行打印出合理的行数和可识别的余额之前，不要添加 cron 行。

这些脚本的大部分问题稍后出现，源于分页和重试。先不要它们，只有当实际运行显示出需要时，再逐一添加。

先读取标志，再读取行

每个响应都有一个 ok 标志，经过身份验证的响应还会添加 _credits。在触碰行之前，请读取两者，因为标志为 false 意味着没有可解析的可靠数据。

401 或 402 是停止标志，而不是循环提示。记录正文并退出，以便下一次计划运行从干净状态开始。

对比

每次调用的成本

每次调用的信用点；1 个信用点 = $0.0001
操作	信用点	脚本中的典型用法
domain, overview, stats, suggest	0	Smoke tests, quick DR lookups
bulk_dr, compare, top, dr_distribution, tld_breakdown	1	对多达 2000 个域的目标列表进行评分
refdomains, backlinks, anchors, toppages, anchor_cloud, intersect	2	Snapshots and competitor gaps
search, keyword	3	Who links with an exact anchor

domains in our link graph: 181,132,097
domain-to-domain links: 2,774,625,913
backlinks indexed: ~798.5 billion
free credit at sign-up: $100

Ten lines you can paste

Standard library only. It stops on the first bad response and prints the balance it sees.

python

import json, urllib.request as u
KEY = 'sk_live_...'
url = ('https://linkzoid.pro/api.php?action=refdomains'
       '&q=example.com&per=100&key=' + KEY)
with u.urlopen(url) as r:
    d = json.load(r)
if not d['ok']:
    raise SystemExit(d)
print(d['total'], 'referring domains')
print(d['_credits'])

常见问题

Questions people ask before scripting this

How do I check website backlinks with a script?: Send a GET request to the refdomains or backlinks action with the target domain in q and your key in key. You get JSON back, 1,000 rows at most per call, billed at 2 credits. Loop on page until you reach total.
Is there a free way to find backlinks?: Partly. The overview, stats, domain and suggest actions are free and need no key. Row-level lists such as refdomains and backlinks cost 2 credits, which the $100 sign-up credit covers many thousands of times over.
它可以在 GitHub Actions 或 cron 上运行吗？: 可以。它是一个带有标头或查询字符串中密钥的 HTTPS GET 请求，因此计划工作流、crontab 行或 systemd 计时器均可使用。将密钥存储为密钥，不要放在仓库中。
数据是否实时更新？: 不。我们的爬虫大约每月刷新一次索引，因此最新的链接可能缺失。每小时轮询没有帮助；每周或每月运行与数据匹配。实时神话页面解释了如何与之配合使用。
积分用完时会发生什么？: API 返回 HTTP 402。您的脚本应停止并报警，而不是重试。从账户页面使用 USDT (TRC-20) 充值，下一次运行将从相同的余额继续。
价格与 Ahrefs API 单位相比如何？: Ahrefs 在订阅中出售 API 单位，每月 $129 起，提供 200,000 个单位，每次请求至少 50 个单位。这里每次调用需要 1 到 3 个积分，每 1,000 次调用 $0.10 起，没有月度最低消费。
响应使用哪种格式？: JSON，始终如此。每个响应都带有 ok 标志，经过身份验证的响应还会添加 _credits，其中包含调用成本和您的剩余余额，这使得支出易于记录。