批量查询引荐域名数量（实时）

接口说明

该接口用于批量获取多个目标的引荐域名数量，目标可为：

• 域名
• 子域名
• 网页 URL

返回的数据基于实时存活的引荐域名统计，即：在最近一次检查中，所有指向目标且存在任意类型反向链接的域名总数。链接类型但不限于：

• nofollow
• noreferrer
• ugc
• sponsored

需要注意：

• 如果将域名作为目标提交，返回结果会按根域名及所有子域名整体统计；
• 例如，提交 example.com 时，统计范围将 example.com 以及 app.example.com 等子域名；
• 该接口统计的是引荐域名数量，不是反向链接条数。

请求信息

请求方式： POST请求地址： https://api.seermartech.cn/v3/backlinks/bulk_referring_domains/live

计费说明

本接口按请求计费。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

参考价约 ¥0.3248 / 次。 请注意，费用会因请求和平台计费策略变化而有所不同。

频率与并发限制

• 每分钟最多可发送 2000 次 API 调用
• 同时并发请求上限为 30

请求体格式

所有 POST 数据需使用 JSON（UTF-8 编码），并以数组形式提交：

[
 {
 "targets": [
 "forbes.com",
 "cnn.com",
 "https://www.apple.com/iphone/"
 ],
 "tag": "batch_001"
 }
]

请求参数

字段名	类型	填	说明
targets	array	是	要查询引荐域名数量的目标列表，可填写域名、子域名或网页 URL。最多支持 1000 个目标。域名或子域名请不要带 https:// 和 www.；网页填写完整绝对地址， http:// 或 https://。
tag	string	否	自定义任务标识，最长 255 个字符。可用于在结果中识别并匹本次请求，对应值会出现在响应的 data 对象中。

目标填写规则

域名 / 子域名

• 不要 https://
• 不要 www.

示例：

• example.com
• blog.example.com

网页

-须使用完整绝对 URL -须 http:// 或 https://

示例：

• https://www.apple.com/iphone/
• https://ahrefs.com/blog/

响应结构

接口返回 JSON 编码数据，顶层 tasks 数组，每个任务对应一次提交项。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表参考 /v3/appendix/errors
status_message	string	通用状态信息，完整列表参考 /v3/appendix/errors
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中执行出错的任务数量
tasks	array	任务结果数组

tasks 数组字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，通常在 10000–60000 范围，完整列表参考 /v3/appendix/errors
status_message	string	任务状态信息，完整列表参考 /v3/appendix/errors
time	string	任务执行耗时，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组中的数量
path	array	请求路径
data	object	回显请求参数，即提交时传的参数
result	array	结果数组

result 数组字段

字段名	类型	说明
items_count	integer	items 数组中的结果数量
items	array	引荐域名统计结果

items 数组字段

字段名	类型	说明
target	string	请求中的目标对象，即域名、子域名或网页
referring_domains	integer	指向该目标的引荐域名总数
referring_domains_nofollow	integer	至少存在一条 nofollow 链接指向该目标的域名数量
referring_main_domains	integer	指向该目标的根域名数量
referring_main_domains_nofollow	integer	至少存在一条 nofollow 链接指向该目标的根域名数量

统计口径说明

referring_domains 与 referring_main_domains 的区别：

• referring_domains：主域名和子域名分别统计；
• referring_main_domains：按根域名去重统计。

例如：

• blog.example.com
• shop.example.com

在 referring_domains 中可能计为两个不同来源； 在 referring_main_domains 中则都归属于 example.com 这个根域名。

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/bulk_referring_domains/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "yelp.com",
 "https://www.apple.com/iphone/",
 "https://ahrefs.com/blog/",
 "ibm.com",
 "https://variety.com/",
 "https://stackoverflow.com/",
 "trustpilot.com"
 ],
 "tag": "batch_ref_domains_live_001"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/bulk_referring_domains/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "yelp.com",
 "https://www.apple.com/iphone/",
 "https://ahrefs.com/blog/",
 "ibm.com",
 "https://variety.com/",
 "https://stackoverflow.com/",
 "trustpilot.com"
 ],
 "tag": "batch_ref_domains_live_001"
 }
]

response = requests.post(url, json=payload, headers=headers)
print(response.json)

TypeScript

import axios from "axios";

const payload = [
 {
 targets: [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "yelp.com",
 "https://www.apple.com/iphone/",
 "https://ahrefs.com/blog/",
 "ibm.com",
 "https://variety.com/",
 "https://stackoverflow.com/",
 "trustpilot.com"
 ],
 tag: "batch_ref_domains_live_001"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/bulk_referring_domains/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .then((response) => {
 // 输出结果数据
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20230825",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "2.5806 sec.",
 "cost": 0.0203,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "2.5806 sec.",
 "cost": 0.0203,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "bulk_referring_domains",
 "live"
 ],
 "data": {
 "api": "backlinks",
 "function": "bulk_referring_domains",
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "yelp.com",
 "https://www.apple.com/iphone/",
 "https://ahrefs.com/blog/",
 "ibm.com",
 "https://variety.com/",
 "https://stackoverflow.com/",
 "trustpilot.com"
 ],
 "tag": "batch_ref_domains_live_001"
 },
 "result": [
 {
 "items_count": 10,
 "items": [
 {
 "target": "forbes.com",
 "referring_domains": 123456,
 "referring_domains_nofollow": 45678,
 "referring_main_domains": 98765,
 "referring_main_domains_nofollow": 34567
 },
 {
 "target": "https://www.apple.com/iphone/",
 "referring_domains": 23456,
 "referring_domains_nofollow": 6789,
 "referring_main_domains": 21098,
 "referring_main_domains_nofollow": 5432
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

建议在接时同时处理顶层状态码与任务状态码：

• 顶层 status_code：表示整个请求是否成功；
• tasks[].status_code：表示单个任务是否成功。

常见处理建议：

1. 判断顶层 status_code 是否为 20000
2. 再遍历 tasks，检查每个任务的 status_code
3. 若 tasks_error 大于 0，说明至少有任务执行失败
4. 按 /v3/appendix/errors 中的错误码定义进行重试、告警或参数修正

使用注意事项

• 单次请求最多提交 1000 个目标
• 域名 / 子域名与网页 URL 的写法不同，提交前需统一校验
• www. 不应出现在域名或子域名目标中
• 本接口返回的是最新检查下的实时引荐域名统计
• nofollow 指标表示“至少存在一条 nofollow 链接”的来源域名数量，而不是 nofollow 链接总条数

实用场景

• 批量评估站点权重：对多个竞品域名或候选投放站点一次性统计引荐域名规模，快速判断外链基础与站点影响力。
• 监控页面级外链表现：针对重点落地页、博客文章或产品页查询页面级引荐域名数量，识别哪些更容易获得自然引用。
• 对比主域与子域外链结构：分别查询根域名和子域名，分析品牌站、博客站、帮助中心等不同站点模块的外链积累差异。
• 筛选高价值外链来源：结合 referring_domains 与 referring_main_domains，识别是否存在大量子域重复引用，评估真实外链广度。
• 跟踪 nofollow 外链占比：观察 referring_domains_nofollow 与 referring_main_domains_nofollow，判断外链来源中 nofollow 类型覆盖，优化外链结构。