批量垃圾分数查询（实时）

POST /v3/backlinks/bulk_spam_score/live

接口说明

/v3/backlinks/bulk_spam_score/live 用于批量获取指定目标的垃圾分数（Spam Score）。支持的目标类型：

• 域名
• 子域名
• 网页 URL

垃圾分数是平台 API 提供的专有指标，用于衡量目标的“垃圾站/垃圾页面”倾向，分值范围为 0 到 100。分值越高，通常表示目标的可疑程度越高。

• 请求方式：POST
• 接口路径：/v3/backlinks/bulk_spam_score/live
• 完整地址：https://api.seermartech.cn/v3/backlinks/bulk_spam_score/live

计费说明

该接口按请求计费。

参考价约 ¥0.3248 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

并发与频率限制

• 每分钟最多可发送 2000 次 API 调用
• 最大并发请求数为 30

请求格式

所有 POST 数据均需使用 JSON（UTF-8 编码）提交。

请求体为 JSON 数组，格式如下：

[
 {
 "targets": [
 "forbes.com",
 "cnn.com",
 "https://www.apple.com/iphone/"
 ],
 "tag": "spam-score-check-001"
 }
]

请求参数

顶层对象字段

字段名	类型	填	说明
targets	array	是	要查询垃圾分数的域名、子域名或网页列表，最多支持 1000 个目标
tag	string	否	自定义任务标识，最长 255 个字符。可用于请求与响应结果匹

targets 填写规则

目标类型	填写要求
域名	不带 https:// 和 www.，例如：example.com
子域名	不带 https:// 和 www.，例如：blog.example.com
网页	须使用完整绝对 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": "batch-spam-score-demo"
 }
]

返回结果说明

接口返回 JSON 数据，顶层 tasks 数组，每个任务对应一次提交的请求对象。

顶层响应字段

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

建议在接时实现完整的异常处理和状态码判断逻辑。

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[] 字段

字段名	类型	说明
type	string	结果类型，固定为 backlinks_bulk_spam_score
target	string	请求中的目标域名、子域名或网页
spam_score	integer	目标的平均垃圾分数，范围通常为 0-100

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/bulk_spam_score/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "https://www.apple.com/iphone/"
 ],
 "tag": "spam-score-check-001"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/bulk_spam_score/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "https://www.apple.com/iphone/"
 ],
 "tag": "spam-score-check-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",
 "https://www.apple.com/iphone/"
 ],
 tag: "spam-score-check-001"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/bulk_spam_score/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.20220819",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.4822 sec.",
 "cost": 0.0203,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "0db4c1d2-6f1a-4a67-9a23-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.4822 sec.",
 "cost": 0.0203,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "bulk_spam_score",
 "live"
 ],
 "data": {
 "api": "backlinks",
 "function": "bulk_spam_score",
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com",
 "https://www.apple.com/iphone/"
 ],
 "tag": "spam-score-check-001"
 },
 "result": [
 {
 "items_count": 4,
 "items": [
 {
 "type": "backlinks_bulk_spam_score",
 "target": "forbes.com",
 "spam_score": 3
 },
 {
 "type": "backlinks_bulk_spam_score",
 "target": "cnn.com",
 "spam_score": 2
 },
 {
 "type": "backlinks_bulk_spam_score",
 "target": "bbc.com",
 "spam_score": 1
 },
 {
 "type": "backlinks_bulk_spam_score",
 "target": "https://www.apple.com/iphone/",
 "spam_score": 4
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

请重点以下层级的状态信息：

• 顶层 status_code：表示整次 API 请求状态
• tasks[].status_code：表示单个任务执行状态

常见处理建议：

• 20000：请求成功
• 非 20000：建议记录 status_message，并结合 /v3/appendix/errors 进行错误处理
• tasks_error > 0：表示本次请求中有任务执行失败，需要逐个检查 tasks

使用建议

• 批量评估外链目标质量时，可调用本接口快速筛查高风险域名或页面
• 若同时处理域名、子域名和页面，请严格对应格式填写 targets
• 页面 URL须为完整地址，否则可能导致解析失败或结果异常
• 如需在业务系统中追踪批次，请使用 tag 记录任务编号

实用场景

• 筛查外链资源：批量评估候选外链站点的垃圾分数，提前过滤高风险站点，降低链接建设中的 SEO 风险
• 审计现有外链组合：对已合作域名、子域名和落地页进行周期性检查，识别质量下降的来源并及时理
• 评估竞争对手链接环境：对竞品常见引荐域或重点页面做垃圾分数扫描，判断外链结构健康度
• 监控页面级风险：针对落地页 URL 查询垃圾分数，发现异常页面信号，支持站群、镜像页或异常引用排查
• 构建自动化风控规则：将 spam_score 接链接采购、投放或合作准流程，按分值阈值自动拦截高风险目标