批量外链数量查询（实时）

接口说明

通过本接口可以一次性查询多个目标的外链总数。目标可以是：

• 域名
• 子域名
• 页面 URL

返回结果为这些目标当前的实时外链数量，即最近一次检测中发现的有效外链总量，各种链接属性的来源链接，例如：

• nofollow
• noreferrer
• ugc
• sponsored

如果传的是域名，返回的是根域名及所有子域名汇总后的外链数量。例如：

• example.com
• app.example.com

当查询 example.com 时，统计口径会覆盖子域。

请求地址

POST https://api.seermartech.cn/v3/backlinks/bulk_backlinks/live

计费说明

该接口按请求计费。

由于原始文档未提供固定单价，无法直接换算参考人民币价格。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

• 每分钟最多 2000 次 API 调用
• 最大并发请求数为 30
• POST 数据需使用 JSON（UTF-8）
• 请求体格式为 JSON 数组：[{ ... }]

---

请求参数

顶层请求体

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

参数说明

字段	类型	填	说明
targets	array	是	需要查询外链数量的目标列表，可填写域名、子域名或网页 URL
tag	string	否	自定义任务标识，用于在响应中回传并匹结果，最大长度 255 个字符

targets 使用规则

• 最多可传 1000 个目标
• 域名或子域名：
• 不要 https://
• 不要 www.
• 页面地址： -须传绝对 URL -须 http:// 或 https://

targets 示例

[
 {
 "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": "bulk_backlinks_demo"
 }
]

---

返回结果

接口返回 JSON 对象，根节点 tasks 数组，每个任务对应一次提交的数据。

顶层字段说明

字段	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码
status_message	string	通用状态信息
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	返回错误的任务数量
tasks	array	任务结果数组

完整错误码与状态码说明可参考 /v3/appendix/errors。建议在接时做好异常状态与错误重试处理。

tasks[] 字段说明

字段	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态说明
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	请求中传的域名、子域名或页面
backlinks	integer	指向该目标的外链数量

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/bulk_backlinks/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": "bulk_backlinks_demo"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/bulk_backlinks/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": "bulk_backlinks_demo"
 }
]

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

TypeScript

import axios from "axios";

const postData = [
 {
 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: "bulk_backlinks_demo"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/bulk_backlinks/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
})
 .then((response) => {
 // 输出返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error.response?.data || error.message);
 });

---

响应示例

{
 "version": "0.1.20210917",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "2.0128 sec.",
 "cost": 0.0203,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "8c5b7f2e-5f0a-4b3c-9f1d-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "2.0011 sec.",
 "cost": 0.0203,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "bulk_backlinks",
 "live"
 ],
 "data": {
 "api": "backlinks",
 "function": "bulk_backlinks",
 "targets": [
 "forbes.com",
 "cnn.com",
 "https://www.apple.com/iphone/"
 ],
 "tag": "bulk_backlinks_demo"
 },
 "result": [
 {
 "items_count": 3,
 "items": [
 {
 "target": "forbes.com",
 "backlinks": 12500000
 },
 {
 "target": "cnn.com",
 "backlinks": 9800000
 },
 {
 "target": "https://www.apple.com/iphone/",
 "backlinks": 452300
 }
 ]
 }
 ]
 }
 ]
}

---

状态码与错误处理

通用状态字段

• 顶层 status_code / status_message：表示整个请求的处理状态
• 任务级 tasks[].status_code / tasks[].status_message：表示单个任务的处理状态

接建议

• 检查顶层 status_code 是否为成功状态
• 再检查 tasks_error 是否为 0
• 对每个任务单独检查 tasks[].status_code
• 当出现异常时，依据 /v3/appendix/errors 进行错误处理、重试或告警

---

使用说明补

• 本接口适合快速批量获取多个站点或页面的外链规模
• 如果传域名，将按根域名口径统计，而不是限单一主机名
• 返回的是实时 live 外链数，不是历史累计快，也不是限某类属性链接

实用场景

• 批量评估竞品站点权重：一次性对多个竞品域名查询外链总量，快速判断行业链接资产分布，市场与 SEO 对标。
• 筛选高价值落地页：对不同页面 URL 统计外链数量，识别自然获链能力强的页，为扩展和链导流提供依据。
• 监控品牌站群外链表现：对主站、子站、专题页批量查询外链规模，统一监控各站点的链接增长，便于发现异常波动。
• 支持外链拓展优级排序：将目标站点当前外链规模作为参考指标，结合流量、主题性等数据，制定更合理的外链建设顺序。
• 做行业样本库基线分析：对一批行业网站进行外链总量扫描，建立基准数据，为后续排名解释、站点分层和机会发现提供支撑。