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

文档

端点参考与定价

一个 URL,多种操作。这是完整的功能概览。

SEOCheck 研究团队 ·

一座坚固的石桥横跨雾气弥漫的山谷,代表可靠的 API 端点

操作与成本

操作积分返回内容
domain免费单个域名的基础记录和 DR
overview免费域名链接概况摘要
stats免费索引级统计数据
suggest免费输入时的域名建议
bulk_dr1最多 2,000 个域名的 DR
compare1最多 20 个域名的并排对比
top1顶级域名
dr_distribution1链接域名的 DR 分布
tld_breakdown1按顶级域名分类的链接
refdomains2引用域名
backlinks2单个外链
anchors2锚文本
toppages2被链接最多的页面
anchor_cloud2锚文本权重
intersect22 到 10 个域名的共享链接者
search3对锚文本、标题和 URL 进行全文搜索
keyword3哪些域名使用了精确锚文本

认证与格式

基础 URL:https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_...。偏好使用标头?请发送 Authorization: Bearer sk_...。

此外链分析 API 返回 JSON 格式数据,并支持跨域调用,因此浏览器可直接调用。每个响应都包含 ok 字段。经过认证的响应还包含 _credits,其中包含该次调用的成本和您的剩余余额。

错误提示直截了当。HTTP 401 表示密钥缺失或错误。HTTP 402 表示余额耗尽。处理这两种错误都很简单,且不应在循环中重试。

首次付费调用前

  • 对您已知的域名运行 overview。它是免费的。
  • 通过一次 1 积分的调用(如 compare)检查密钥是否有效。
  • 读取响应中的 _credits 并确认成本与上表一致。
  • 设置 HTTP 402 的脚本警报,以免余额耗尽时静默失败。

分页与排序

每次调用最多返回 1,000 行。使用 per 参数指定每页行数(10 到 5000),使用 page 翻页,并使用 sort 和 order 进行排序。

bash
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
园丁使用专用剪刀仔细修剪盆景,象征精确的调整

改变结果的参数

每项操作都需要两个基本参数 action 和 q,以及一些可选选项。请先阅读它们。大多数错误源于那些看似可选但会改变成本或行格式的选项。在从论坛或博客复制调用前,请先阅读选项说明。

以下示例假设 key 参数中包含密钥。请将占位符替换为您自己的密钥。将密钥保存在环境变量中,而不是提交到代码库的文件中。此外链分析 API 参考中的所有示例均使用相同的基础 URL。

使用 page 和 per 进行分页

per 选项设置返回的行数,范围为 10 到 5000。page 选项用于遍历数据集。请求 500 行然后请求第 2 页,将返回下一批数据,而不是同一批数据的重复拉取。

深度分页上限为 50,000 行。如果需要更多数据,请使用 sort 缩小查询范围,或按域名拆分任务,以确保每次调用都在限制范围内。

使用 sort 和 order 进行排序

在服务器端排序,而不是在脚本中排序。请求 sort=dr&order=desc 将首先返回权重最高的链接域名,使您关注的行出现在第一页。下载完整数据后再过滤会浪费时间和积分。

当您需要查看权重较低的行时(例如查找链接稀疏的域名或发现链接概况突然下降),使用 order=asc。

列表操作:bulk_dr、compare 和 intersect

列表类操作可在一次调用中处理多个域名。bulk_dr 接受最多 2,000 个域名,仅需 1 积分,支持 GET 查询字符串或 POST 请求体。compare 最多支持 20 个域名,intersect 支持 2 到 10 个域名。

由于价格不取决于行数,一次调用长列表比多次短调用更便宜。例如,周一检查 1,500 个潜在客户网站,只需一次调用,而非 1,500 次。

搜索和关键词调用成本更高

search 操作对锚文本、标题和 URL 进行全文搜索。keyword 操作查询哪些域名使用了精确锚文本。这两项操作每次调用均需 3 积分,因此建议用于回答特定问题,而非浏览数据。

首次拉取时选择 per 和 page

首次查看新域名时,建议从较小的 per 值(如 50)开始。您可以在一次简短的响应中看到行的格式、字段名称和成本。仅在确认数据符合需求后再增加 per 值。此习惯适用于上表中的所有操作。

一个常见错误是首次尝试就请求 5,000 行,然后丢弃大部分数据。这会导致响应变大、等待时间变长,且预期的节省并未实现。

读取积分余额

每个经过认证的响应末尾都包含 _credits,显示该次调用的成本和调用后的余额。请记录该数据。月底汇总后,您就能精确知道实际账单。

粗略估算预算很有帮助。一千次 refdomains 调用需 2,000 积分,即 $0.20。一千次 search 调用需 3,000 积分,即 $0.30。对 2,000 个域名列表运行一次 bulk_dr 仅需 1 积分,即每月约 $0.003。

与 Ahrefs 列出的每月 $129 起、包含 200,000 API 单位的计划相比,账单结构不同。详见比较。

一对复古黄铜天平平衡两种不同的重量,代表不同的错误类型

读取错误和 _credits 字段

响应可能以两种不同方式失败,您的代码应区别处理。这是两个不同的问题。密钥错误是配置问题,余额不足是账单问题。将两者视为同一通用错误会掩盖所需的修复措施。

首先读取 ok 字段,然后读取 _credits 块。之后再看数据行,因为当您已知调用成本时,结果缺失或行数较少更容易解释。

分别处理 401 和 402

HTTP 401 表示密钥缺失或错误。停止任务并修复密钥。HTTP 402 表示余额已耗尽。从账户页面充值,然后继续操作。重试 401 无效,未充值就重试 402 也无效。

记录运行前后的余额

在运行开始时和结束时记录 _credits 余额。差值应与预期调用成本一致。如果差值过大,说明循环执行次数超出预期。

快速检查方法:将调用次数乘以积分成本。如果计算结果为 40,但余额减少了 4,000,说明脚本有问题,而非价格表有误。

检查请求的数据行

返回行数少于预期的成功响应不一定是错误。小域名可能确实链接较少。将行数与您发送的 per 值进行比较,将差异视为需要解答的问题,而非需要隐藏的故障。

先测试低成本调用

将调用集成到任务前,先用最小的合理参数手动运行一次。检查响应、字段名称和 _credits 值。在第二行出错的任务比首次调用就失败的任务更难调试。

API 首次会话

按顺序进行四次调用,确保后续调用都是您已理解的操作。仅第一次调用免费,这是有意为之。

01

对您已知的域名运行 overview

该操作免费且无需密钥。将摘要与搜索引擎控制台和网站本身的数据进行对比,以便了解正常响应的样子。

02

通过一次 1 积分的调用测试密钥

发送 compare 请求,包含您的域名和一个竞争对手。确认 ok 字段为 true,且 _credits 显示成本为 1 积分。

03

使用较小的 per 值获取 2 积分的列表

请求 refdomains,设置 per=50 和 sort=dr。检查行数和积分成本是否与上表一致。

04

将成本记录到日志中

记录运行前后的余额。从现在开始,您编写的每个脚本都应养成此习惯,让意外账单变成日志中的一行,而非谜团。

定价

预付费积分。1 积分 = $0.0001。无订阅费,无月度最低消费。

免费操作

$0

  • domain, overview, stats, suggest
  • 无需密钥
  • 驱动网页检查器
打开检查器

按量付费

$0.10每 1,000 次 1 积分调用

  • 注册即送 $100 免费积分
  • 无需绑定信用卡
  • 使用 USDT (TRC-20) 充值
  • 按调用计费,而非按行计费
领取 $100 免费额度

您需要注意的限制

索引涵盖 181,132,097 个域名和 2,774,625,913 个域名链接。索引每月更新一次,速度慢于每日抓取。

深度分页上限为 50,000 行。如需更多数据,请使用 sort 缩小查询范围,或按域名拆分任务。

登录仅限 Google,充值使用 USDT。从 DR 检查器 开始,使用 竞争对手指南 进行竞品审计,或阅读为什么一些团队在纯链接工作中放弃 Ahrefs API。

常见问题

我按行付费吗?

不。每次调用仅计费一次,无论返回 10 行还是 1,000 行。

积分耗尽时会发生什么?

API 将返回 HTTP 402。从账户页面使用 USDT (TRC-20) 充值即可继续。

我在哪里找到密钥?

Google 登录后在仪表板中查找。