如何通过 API 进行域名反向链接检查？

将域名作为 q 发送到 overview、refdomains 或 backlinks 等操作，并读取 JSON。免费操作无需密钥。付费操作需要在 bearer 头或 key= 中提供密钥，每次调用消耗 1 到 3 个信用点，无论行数多少。

我必须将密钥放在浏览器中吗？

不需要，也不应该。CORS 是开放的，因此浏览器可以调用 API，但客户端代码中的密钥对所有访客都是公开的。将付费调用保留在您的服务器上，让前端与您的路由进行通信。

信用点用完后会发生什么？

API 将返回 HTTP 402。密钥缺失或错误将返回 HTTP 401。将两者视为停止信号，而不是重试。您可以在账户页面使用 USDT (TRC-20) 充值，同一密钥将继续有效。

每次调用返回多少行？

每次调用最多 1,000 行，每次调用仅计费一次，无论行数多少。使用 page 和 per 进行分页。深度分页上限为 50,000 行，因此对于更大的导出，请通过排序或不同的操作缩小查询范围。

这里的 DR 与 Ahrefs 中的数字相同吗？

不同。这里的 DR 是我们自己的指标：round(100 log(ref_domains + 1) / log(2 10^7))。其精神与 Ahrefs DR 或 Moz DA 类似，但基于我们自己的索引计算，因此请在同一工具内比较趋势，而非跨工具比较数值。

链接数据有多新？

大约一个月。索引大约每月重建一次，因此最近的链接可能缺失。如果您的产品承诺对新链接提供每日警报，您需要每日爬虫供应商和本 API 来获取廉价的批量数据。

有月费或最低消费吗？

无订阅，无最低消费。信用点为预付费：1 个信用点成本 $0.0001，因此 1,000 次单信用点调用成本 $0.10。新账户获得 $100 免费信用点，无需信用卡，仅需 Google 登录。

JSON 格式外链数据：$100 免费额度，无需绑卡，支持 Google 账号登录。

已索引 798.5 billion 反向链接

用于您自己仪表板的域名反向链接检查

一个返回引用域名、锚文本、顶级页面和 DR 的 REST 端点，格式为 JSON。围绕它构建您的工具，前 $100 的调用由我们承担。

获取 $100 免费额度阅读批量 DR 脚本

四项操作完全无需密钥
一次调用即可评分多达 2,000 个域名
支持 CORS，密钥可为 bearer 或查询字符串形式

GET /api.php?action=domainJSON

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

用途

域名反向链接检查：您最先对接的四个端点

每项操作均以 q 中的目标为输入，并返回带有 ok 标志的 JSON。根据您的界面需求选择，而非仅凭听起来是否 impressive。

免费查询，无需密钥

domain、overview、stats 和 suggest 免费。可用于公共小部件或 CI 中的冒烟测试。

整个投资组合的批量 DR

bulk_dr 每次调用可为多达 2,000 个域名评分，消耗 1 个信用点。一次夜间请求即可覆盖大型客户列表。

引用域名和锚文本

refdomains、anchors 和 backlinks 每次调用消耗 2 个信用点，每个端点最多返回 1,000 行，支持 page、per、sort 和 order。

用于差距表的交集

intersect 接受 2 到 10 个域名，列出共同链接它们的域名。消耗 2 个信用点，无论行数多少。

适用对象

JSON 背后的内容

数据来自我们自己的爬虫和链接索引：181,132,097 个域名，2,774,625,913 个域名间链接，以及约 798.5 billion 反向链接。数据非第三方转售。

索引大约每月刷新一次。上周放置的链接可能尚未收录，因此请设计 UI 以显示索引年龄，而非承诺实时数据。

经过身份验证的响应包含一个 _credits 对象，其中包含本次调用的成本和您的剩余余额。请记录它。您的财务人员会询问支出去向，而答案已包含在每次响应中。

在编写代码之前，有两页文档值得阅读：DR 字段参考解释了 0-100 分数的含义，仪表板代理指南展示了密钥应放置的位置。

首次渲染是否需要这些数字？

这取决于谁在查看页面。如果您希望搜索引擎索引的公共查询，其数字应已包含在 HTML 中。登录后的仪表板可以在加载后获取行数据，尽管在慢速手机上空白表格看起来可能不完整。

我们建议的默认设置很简单：您的服务器调用 API，渲染行数据，浏览器仅负责排序和过滤。代理指南展示了在 Next.js 中的这种分离方式，并包含了路由处理器。

密钥应放置的位置，再次说明

密钥不应出现在访客可以打开的页面中。将其保存在服务器环境变量中，并从运行该秘密代码的地方发起调用。

承诺在 bundle 中隐藏密钥的工具只是对普通读者隐藏，而非对打开网络标签的任何人都隐藏。

一次请求，端到端

替换您的密钥。q 的值是不带协议或路径的裸域名。

bash

curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
  -H "Authorization: Bearer sk_live_..."

# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the error

检查清单

首次生产部署之前

密钥位于服务器端环境变量中，绝不位于浏览器 bundle 中
每次响应都检查 ok，而不仅仅是 HTTP 状态
HTTP 401 和 402 不会自动重试
_credits 在每次调用时写入您的日志
UI 显示每月刷新时间，因此没有人会将数据视为实时数据
分页在 50,000 行上限处停止，而不是无限循环

范围

链接数据 API，而非完整的 SEO 套件

关键词研究和排名追踪以及每日新鲜爬虫更适合由 Ahrefs 或 Semrush 提供服务。Ahrefs 在订阅中包含 API 单元，订阅起价为每月 $129，包含 200,000 个单元。本 API 按调用次数对链接数据定价。

适用场景：仪表板、审计、批量评分、内部工具
不太适用场景：排名追踪、关键词量、实时链接警报
数据每月刷新，文档已明确说明

工作原理

从登录到夜间任务

1
使用 Google 登录
账户页面会生成您的 sk_ 密钥，并显示 $100 的起始余额，即 1,000,000 个信用点。
2
运行一次免费操作
调用您熟悉的域名的 overview。在构建任何内容之前，将输出与您预期的结果进行比较。
3
编写 fetch 层
封装 fetch 一次：密钥注入、ok 检查、_credits 日志记录。查看分页说明以了解分页循环。
4
安排任务
深度拉取每月运行一次，bulk_dr 每晚运行。错误表涵盖了夜间任务出错时的处理方法。

常见问题

开发者首先提出的问题

如何通过 API 进行域名反向链接检查？: 将域名作为 q 发送到 overview、refdomains 或 backlinks 等操作，并读取 JSON。免费操作无需密钥。付费操作需要在 bearer 头或 key= 中提供密钥，每次调用消耗 1 到 3 个信用点，无论行数多少。
我必须将密钥放在浏览器中吗？: 不需要，也不应该。CORS 是开放的，因此浏览器可以调用 API，但客户端代码中的密钥对所有访客都是公开的。将付费调用保留在您的服务器上，让前端与您的路由进行通信。
信用点用完后会发生什么？: API 将返回 HTTP 402。密钥缺失或错误将返回 HTTP 401。将两者视为停止信号，而不是重试。您可以在账户页面使用 USDT (TRC-20) 充值，同一密钥将继续有效。
每次调用返回多少行？: 每次调用最多 1,000 行，每次调用仅计费一次，无论行数多少。使用 page 和 per 进行分页。深度分页上限为 50,000 行，因此对于更大的导出，请通过排序或不同的操作缩小查询范围。
这里的 DR 与 Ahrefs 中的数字相同吗？: 不同。这里的 DR 是我们自己的指标：round(100 log(ref_domains + 1) / log(2 10^7))。其精神与 Ahrefs DR 或 Moz DA 类似，但基于我们自己的索引计算，因此请在同一工具内比较趋势，而非跨工具比较数值。
链接数据有多新？: 大约一个月。索引大约每月重建一次，因此最近的链接可能缺失。如果您的产品承诺对新链接提供每日警报，您需要每日爬虫供应商和本 API 来获取廉价的批量数据。
有月费或最低消费吗？: 无订阅，无最低消费。信用点为预付费：1 个信用点成本 $0.0001，因此 1,000 次单信用点调用成本 $0.10。新账户获得 $100 免费信用点，无需信用卡，仅需 Google 登录。