批量查询新增与流失引用域名（实时）

接口说明

该接口用于批量获取指定目标的新增与流失引用域名数量。目标可为：

• 域名
• 子域名
• 网页 URL

接口会返回每个目标在指定时间阈值之后的：

• new_referring_domains：新增引用域名数
• lost_referring_domains：流失引用域名数
• new_referring_main_domains：新增主引用域名数
• lost_referring_main_domains：流失主引用域名数

如果将域名作为目标传，返回结果基于根域名及所有子域名汇总统计。例如传 example.com，会统计 example.com 及所有子域名的数据。

支持查询最近 365 天 的历史数据。

请求方式

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

计费说明

该接口按请求计费。

参考价请以参考单价换算，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

限制说明

• 所有 POST 数据使用 JSON（UTF-8 编码）
• 请求体为 JSON 数组格式：[{ ... }]
• 每分钟最多可发送 2000 次 API 调用
• 同时并发请求数最多 30
• 单次请求中，targets 最多可 1000 个目标

请求参数

POST 数组对象字段

字段名	类型	说明
targets	array	填。需要查询新增/流失引用域名的目标列表。最多支持 1000 个域名、子域名或网页。域名或子域名请不要 https:// 和 www.；网页使用完整绝对 URL， http:// 或 https://。
date_from	string	可选。时间范围起始日期，用作新增/流失判定阈值。指定日期之后首次出现在索引中的引用域名将被视为“新增”；指定日期之后未再发现、但此前存在的引用域名将被视为“流失”。默认值为“今天减 1 个月”。最小值为“今天减 1 年”。格式：yyyy-mm-dd，例如 2023-09-01。
tag	string	可选。自定义任务标识，最长 255 个字符。可用于请求与响应结果对，响应中的 data 对象会返回该值。

targets 填写规则

• 查询域名：example.com
• 查询子域名：blog.example.com
• 查询网页：https://www.example.com/page/

注意：

• 域名/子域名：不要带 https:// 和 www.
• 网页：带完整协议头 http:// 或 https://

响应结构

接口返回 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	array	任务结果数组

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常在 10000-60000，完整列表参考 /v3/appendix/errors
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	请求中传的域名、子域名或网页
new_referring_domains	integer	指向该目标的新增引用域名数量
lost_referring_domains	integer	指向该目标的流失引用域名数量
new_referring_main_domains	integer	指向该目标的新增主引用域名数量
lost_referring_main_domains	integer	指向该目标的流失主引用域名数量

判定逻辑说明

date_from 用于界定“新增”和“流失”：

• 新增引用域名：在本平台索引中，于 date_from 之后首次出现的引用域名
• 流失引用域名：在 date_from 之后未再发现、但在此之前曾存在的引用域名

例如：

• 今天是 2021-10-13
• 未传 date_from 时，默认值为 2021-09-13
• 最早可传值为 2020-10-13

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/bulk_new_lost_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"
 ],
 "date_from": "2023-09-01"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/bulk_new_lost_referring_domains/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "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"
 ],
 "date_from": "2023-09-01"
 }
]

response = requests.post(url, json=data, headers=headers)
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"
 ],
 date_from: "2023-09-01"
 }
];

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

响应示例

{
 "version": "0.1.20230825",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "10.7157 sec.",
 "cost": 0.0203,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "10.7157 sec.",
 "cost": 0.0203,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "bulk_new_lost_referring_domains",
 "live"
 ],
 "data": {
 "api": "backlinks",
 "function": "bulk_new_lost_referring_domains",
 "targets": [
 "forbes.com",
 "cnn.com",
 "bbc.com"
 ],
 "date_from": "2023-09-01"
 },
 "result": [
 {
 "items_count": 3,
 "items": [
 {
 "target": "forbes.com",
 "new_referring_domains": 123,
 "lost_referring_domains": 45,
 "new_referring_main_domains": 98,
 "lost_referring_main_domains": 31
 },
 {
 "target": "cnn.com",
 "new_referring_domains": 87,
 "lost_referring_domains": 20,
 "new_referring_main_domains": 65,
 "lost_referring_main_domains": 17
 },
 {
 "target": "bbc.com",
 "new_referring_domains": 56,
 "lost_referring_domains": 12,
 "new_referring_main_domains": 40,
 "lost_referring_main_domains": 9
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

• 顶层 status_code 表示整个请求的执行状态
• tasks[].status_code 表示单个任务的处理状态
• 建议同时检查：
• HTTP 状态码
• 顶层 status_code
• tasks_error
• 各任务下的 tasks[].status_code

常见处理建议：

• 20000：请求成功
• 非 20000：根据 /v3/appendix/errors 进行异常处理
• 若 tasks_error > 0：说明部分任务执行失败，应逐项检查 tasks 数组中的状态信息

使用建议

• 批量对比多个域名时，优统一 date_from，便于横向比较新增/流失趋势
• 如果要分析页面级外链变化，请确保 targets 中传完整页面 URL
• 若站群或多子域的整体表现，应直接传根域名以获取聚合结果
• 可通过 tag 项目、客户、批次号或分析任务

实用场景

• 监控外链波动：批量跟踪多个站点或落地页的新增/流失引用域名，快速发现外链增长或下滑异常。
• 评估活动传播效果：对专题页、产品页或 PR 页面进行时间阈值对比，判断活动后是否带来了新的引用站点。
• 识别链接流失风险：定期检查流失引用域名数量，及时定位可能失效的合作链接、媒体链接或引用。
• 横向对标竞品：将自身网站与竞品域名放在同一批次查询，比较同周期的引用域名增长与流失表现。
• 分析子域或页面资产价值：对博客、帮助中心、产品页等不同资产分别监控，识别最能持续吸引外部引用的类型。