批量获取外链权重分值（Bulk Ranks）实时接口

接口说明

该接口用于批量获取 targets 数组中指定目标的权重分值（rank）。目标可以是：

• 域名
• 子域名
• 网页 URL

rank 的计算基于指向目标的引用域名数量，属于实时数据，取值范围为：

• 0：未检测到外链
• 1000：最高权重

该评分机制与链接数据库中的节点权重计算原理一致，类似早期搜索引擎中的 PageRank 思路。

请求方式

POST /v3/backlinks/bulk_ranks/live

完整请求地址：

https://api.seermartech.cn/v3/backlinks/bulk_ranks/live

计费与频率限制

• 按请求计费
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
• 支持的请求体格式为 UTF-8 编码 JSON
• POST 请求体为 JSON 数组：[{ ... }]
• 每分钟最多可发送 2000 次 API 调用
• 最多支持 30 个并发请求

请求参数

任务对象字段

字段名	类型	填	说明
targets	array	是	需要获取 rank 的域名、子域名或网页列表。最多支持 1000 个目标。域名或子域名需去掉 https:// 和 www.；网页使用完整绝对 URL， http:// 或 https://
rank_scale	string	否	定义 rank、domain_from_rank、page_from_rank 的展示量级。可选值：one_hundred（0–100）、one_thousand（0–1000）。默认值：one_thousand
tag	string	否	用户自定义任务标识，最大长度 255 个字符。可用于在响应结果中匹任务

targets 填写规则

• 域名示例：forbes.com
• 子域名示例：blog.example.com
• 网页示例：https://www.apple.com/iphone/

注意：

• 域名或子域名不要带 https://
• 域名或子域名不要带 www.
• 若目标是网页，传完整 URL

返回结果

接口返回 JSON 编码数据，顶层 tasks 数组。

顶层字段说明

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

tasks[] 字段说明

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

result[] 字段说明

字段名	类型	说明
items_count	integer	items 数组中的结果数量
items	array	返回的目标权重数据列表

items[] 字段说明

字段名	类型	说明
target	string	请求中传的域名、子域名或网页
rank	integer	目标的权重分值。为请求当天的实时值，计算逻辑基于链接数据库中的节点排序原理

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/bulk_ranks/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"
 ],
 "rank_scale": "one_thousand",
 "tag": "bulk-ranks-demo"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/bulk_ranks/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"
 ],
 "rank_scale": "one_thousand",
 "tag": "bulk-ranks-demo"
 }
]

response = requests.post(url, headers=headers, json=payload)
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"
 ],
 rank_scale: "one_thousand",
 tag: "bulk-ranks-demo"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/bulk_ranks/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.response?.data || error.message);
 });

响应示例

{
 "version": "0.1.20210917",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.5195 sec.",
 "cost": 0.0203,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "7f3b1f2c-8c8a-4d14-9d25-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.5191 sec.",
 "cost": 0.0203,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "bulk_ranks",
 "live"
 ],
 "data": {
 "api": "backlinks",
 "function": "bulk_ranks",
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "https://www.apple.com/iphone/"
 ],
 "rank_scale": "one_thousand",
 "tag": "bulk-ranks-demo"
 },
 "result": [
 {
 "items_count": 4,
 "items": [
 {
 "target": "forbes.com",
 "rank": 980
 },
 {
 "target": "cnn.com",
 "rank": 965
 },
 {
 "target": "bbc.com",
 "rank": 952
 },
 {
 "target": "https://www.apple.com/iphone/",
 "rank": 811
 }
 ]
 }
 ]
 }
 ]
}

状态码与异常处理

• 顶层 status_code 表示整次请求是否成功
• tasks[].status_code 表示任务执行状态
• 建议同时校验：
• HTTP 状态码
• 顶层 status_code
• 任务级 tasks[].status_code

常见处理建议：

场景	建议
HTTP 请求失败	检查网络、网、认证信息
status_code 非 20000	按 /v3/appendix/errors 中的错误码处理
tasks_error 大于 0	遍历 tasks，定位失败任务
返回结果为空	检查 targets 格式是否正确，是域名是否 www. 或协议头

使用说明补

• 单次请求最多提交 1000 个目标，适合做批量站点评估
• 若需要更适合展示的分值，可将 rank_scale 设为：
• one_hundred
• one_thousand
• rank 为实时值，会随外链数据变化而变化
• 同一请求中可混合传域名、子域名与页面 URL

实用场景

• 批量评估候选外链站点，快速识别高权重域名，提升外链投放与合作筛选效率
• 对比竞品媒体资源，按域名或页面 rank 判断链接价值，优化数字与分发策略
• 监控重点落地页权重，观察页面级外链积累效果，为专题页或商品页 SEO 提供依据
• 筛选可优争取的子域名，识别高价值栏目或社区版块，提高外链建设命中率
• 建立外链资产评分模型，将 rank 纳站点质量评估体系，支持自动化 SEO 评分与报表分析