反向链接历史数据实时查询

POST /v3/backlinks/history/live

接口说明

该接口用于查询目标域名的历史反向链接数据，最早可追溯至 2019-01-01。你可以按时间范围获取指定域名在各历史时间点的：

• 反向链接总量
• 新增/丢失反向链接数量
• 引用域数量
• 新增/丢失引用域数量
• 被抓取页面数
• 垃圾分数、损坏页面、引用 IP / 子网、链接属性分布等

接口按月返回聚合数据；每条记录表示该目标在对应月份统计时点的反向链接概况。

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

计费说明

该接口按请求计费。

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

此外，接口支持高并发调用，最高可达 每分钟 2000 次 API 调用。

请求体

所有 POST 数据均应使用 UTF-8 编码的 JSON 格式提交。 请求体为 JSON 数组，格式如下：

[
 {
 "target": "cnn.com",
 "date_from": "2020-01-01",
 "date_to": "2021-01-01"
 }
]

请求参数

字段名	类型	填	说明
target	string	是	目标域名。传域名本身，不要 https:// 和 www.
date_from	string	否	时间范围起始日期。最小值为 2019-01-01。如不传，默认使用最早可用日期。格式：yyyy-mm-dd，例如 2019-01-15
date_to	string	否	时间范围结束日期。如不传，默认使用当天日期。格式：yyyy-mm-dd，例如 2019-01-15
rank_scale	string	否	定义 rank、domain_from_rank、page_from_rank 的展示刻度。可选值：one_hundred（0–100）、one_thousand（0–1000）。默认值：one_thousand
tag	string	否	自定义任务标识，最长 255 字符。可用于请求结果匹，响应中的 data 对象会原样返回该值

响应结构

接口返回 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，完整列表参考 /v3/appendix/errors
status_message	string	任务状态说明
time	string	任务执行耗时，单位秒
cost	float	该任务费用，单位 USD
result_count	integer	result 数组数量
path	array	URL 路径
data	object	回显请求时提交的参数
result	array	结果数组

result[] 字段

字段名	类型	说明
target	string	请求中的目标域名
date_from	string	起始日期，UTC 格式：yyyy-mm-dd
date_to	string	结束日期，UTC 格式：yyyy-mm-dd
items_count	integer	items 数组中的结果数量
items	array	历史反向链接数据列表

items[] 字段

items 中的数据按月提供；各指标基于该月份统计时点的目标链接数据进行聚合。

字段名	类型	说明
type	string	素类型，固定为 backlinks_history
date	string	数据存储时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
rank	integer	目标域名在该日期的权重值
backlinks	integer	反向链接总数
new_backlinks	integer	新增反向链接数，基于与上一统计周期对比得出。该字段自 2021 年 5 月起提供；若请求时间早于该时间，返回 0
lost_backlinks	integer	丢失反向链接数，基于与上一统计周期对比得出。该字段自 2021 年 5 月起提供；若请求时间早于该时间，返回 0
new_referring_domains	integer	新增引用域数量。该字段自 2021 年 5 月起提供；若请求时间早于该时间，返回 0
lost_referring_domains	integer	丢失引用域数量。该字段自 2021 年 5 月起提供；若请求时间早于该时间，返回 0
crawled_pages	integer	已抓取页面数
info	object	目标基础信息
internal_links_count	integer	站链接总数，为目标页面集合上的链接总和
external_links_count	integer	站外链接总数，为目标页面集合上的外部链接总和
broken_backlinks	integer	指向目标的失效反向链接数量
broken_pages	integer	接收反向链接但返回 4xx 或 5xx 状态码的页面数量
referring_domains	integer	引用域数量；此指标中子域名会按独立域名计数
referring_domains_nofollow	integer	至少存在 1 条 nofollow 链接指向目标的引用域数量
referring_main_domains	integer	引用主域数量
referring_main_domains_nofollow	integer	至少存在 1 条 nofollow 链接指向目标的引用主域数量
referring_ips	integer	指向目标的引用 IP 数量
referring_subnets	integer	指向目标的引用子网数量
referring_pages	integer	指向目标的引用页面数量
referring_links_tld	object	引用链接来源顶级域分布，键为 TLD，值为数量
referring_links_types	object	引用链接类型分布
referring_links_attributes	object	引用链接属性分布
referring_links_platform_types	object	引用平台类型分布
referring_links_semantic_locations	object	引用链接在 HTML 语义结构中的位置分布
referring_links_countries	object	引用链接来源国家分布，键为 ISO 国家代码
referring_pages_nofollow	integer	至少存在 1 条 nofollow 链接指向目标的引用页面数量

info 字段

字段名	类型	说明
server	string	服务器类型
cms	string	管理系统
platform_type	array	平台类型
ip_address	string	目标 IP 地址
country	string	识别出的目标所属国家代码
is_ip	boolean	是否为 IP 形式目标。若为 true，表示目标本身作为 IP 地址工作，而非标准域名
target_spam_score	integer	目标垃圾分数。若目标为域名/子域，则表示所有页面垃圾分数的平均值

referring_links_types 可选值

• anchor
• image
• link
• meta
• canonical
• alternate
• redirect

referring_links_platform_types 可选值

• cms
• blogs
• ecommerce
• message-boards
• wikis
• news
• organization

referring_links_semantic_locations 说明

该对象表示引用链接位于 HTML 语义中的分布，例如：

• article
• section
• summary

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/history/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "cnn.com",
 "date_from": "2020-01-01",
 "date_to": "2021-01-01"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/history/live"
payload = [
 {
 "target": "cnn.com",
 "date_from": "2020-01-01",
 "date_to": "2021-01-01"
 }
]
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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

TypeScript

import axios from "axios";

const payload = [
 {
 target: "cnn.com",
 date_from: "2020-01-01",
 date_to: "2021-01-01",
 },
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/history/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": "0.1571 sec.",
 "cost": 0.02012,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "backlinks",
 "function": "history",
 "target": "ibm.com",
 "date_from": "2020-08-01",
 "date_to": "2021-01-01"
 },
 "result": [
 {
 "type": "backlinks_history",
 "date": "2020-10-31 00:00:00 +00:00",
 "rank": 602,
 "backlinks": 8561190,
 "new_backlinks": 455524,
 "lost_backlinks": 156158,
 "new_referring_domains": 4580,
 "lost_referring_domains": 388,
 "crawled_pages": 2485792,
 "info": {
 "server": null,
 "cms": null,
 "platform_type": [],
 "ip_address": "104.109.76.210",
 "country": null,
 "is_ip": false,
 "target_spam_score": 0
 },
 "internal_links_count": 49573669,
 "external_links_count": 6900594,
 "broken_backlinks": 0,
 "broken_pages": 157439,
 "referring_domains": 203646,
 "referring_domains_nofollow": 4969,
 "referring_main_domains": 155524,
 "referring_main_domains_nofollow": 3812,
 "referring_ips": 101117,
 "referring_subnets": 57034,
 "referring_pages": 7831950,
 "referring_links_tld": {
 "com": 3718284,
 "org": 1170115,
 "tv": 867765,
 "edu": 598029,
 "net": 366456,
 "ru": 167229,
 "io": 118880,
 "de": 72381,
 "com.br": 65144,
 "it": 35100
 },
 "referring_links_types": {
 "anchor": 7770042,
 "redirect": 60217,
 "canonical": 1672,
 "alternate": 19
 },
 "referring_links_attributes": {
 "nofollow": 970935,
 "noopener": 745230,
 "noreferrer": 167836,
 "external": 88874,
 "ugc": 8085,
 "bookmark": 2462,
 "alternate": 687,
 "author": 398,
 "tag": 362,
 "sponsored": 124
 },
 "referring_links_platform_types": {
 "unknown": 6897418,
 "cms": 776539,
 "blogs": 710442,
 "wikis": 40448,
 "ecommerce": 22248,
 "message-boards": 16470
 },
 "referring_links_semantic_locations": {
 "": 3845675,
 "footer": 2146663,
 "section": 974315,
 "article": 463646,
 "header": 124594,
 "aside": 118868,
 "nav": 107545,
 "main": 43866,
 "figure": 5432,
 "figcaption": 988
 },
 "referring_links_countries": null,
 "referring_pages_nofollow": 46312
 },
 {
 "type": "backlinks_history",
 "date": "2020-12-31 00:00:00 +00:00",
 "rank": 603,
 "backlinks": 8900727,
 "new_backlinks": 185603,
 "lost_backlinks": 68434,
 "new_referring_domains": 1466,
 "lost_referring_domains": 153,
 "crawled_pages": 2610252,
 "info": {
 "server": null,
 "cms": null,
 "platform_type": [],
 "ip_address": "104.109.76.210",
 "country": null,
 "is_ip": false,
 "target_spam_score": 0
 },
 "internal_links_count": 52322051,
 "external_links_count": 7251238,
 "broken_backlinks": 0,
 "broken_pages": 162728,
 "referring_domains": 209218,
 "referring_domains_nofollow": 5153,
 "referring_main_domains": 159477,
 "referring_main_domains_nofollow": 3954,
 "referring_ips": 103145,
 "referring_subnets": 57852,
 "referring_pages": 8156763,
 "referring_links_tld": {
 "com": 3766489,
 "org": 1352682,
 "tv": 868091,
 "edu": 598769,
 "net": 376591,
 "ru": 206205,
 "io": 127906,
 "de": 76675,
 "com.br": 71597,
 "it": 37572
 },
 "referring_links_types": {
 "anchor": 8093750,
 "redirect": 61248,
 "canonical": 1745,
 "alternate": 20
 },
 "referring_links_attributes": {
 "nofollow": 970410,
 "noopener": 736981,
 "noreferrer": 175502,
 "external": 91788,
 "ugc": 8854,
 "bookmark": 2472,
 "alternate": 659,
 "author": 401,
 "tag": 366,
 "sponsored": 133
 },
 "referring_links_platform_types": {
 "unknown": 7201817,
 "cms": 793888,
 "blogs": 726552,
 "wikis": 41098,
 "ecommerce": 24428,
 "message-boards": 16765
 },
 "referring_links_semantic_locations": {
 "": 3939792,
 "footer": 2366930,
 "section": 963461,
 "article": 477386,
 "header": 131548,
 "aside": 121288,
 "nav": 102878,
 "main": 46563,
 "figure": 5535,
 "figcaption": 1020
 },
 "referring_links_countries": null,
 "referring_pages_nofollow": 13800
 }
 ]
 }
 ]
}

错误处理

• 顶层 status_code 表示整次请求状态
• tasks[].status_code 表示任务状态
• 若需统一处理异常、限流、参数错误、权限问题等，请参考 /v3/appendix/errors

常见处理建议：

1. 判断 HTTP 状态码是否为 200
2. 再判断顶层 status_code 是否为 20000
3. 遍历 tasks，检查每个任务的 status_code
4. 若 tasks_error 大于 0，应记录失败任务并重试或告警
5. 费用核对以响应中的 cost 字段为准

使用说明补

• 历史数据最早从 2019-01-01 开始提供
• 返回结果按月聚合，不是按天逐条返回
• 新增/丢失类指标从 2021 年 5 月 开始可用，更早时间段会返回 0
• rank_scale 影响权重类字段的展示刻度，不影响原始链接数量统计
• target 应只传裸域名，不要带协议头或 www. 前缀

实用场景

• 监控站点外链趋势：按月跟踪反向链接总量、引用域和权重变化，及时识别站点外链增长或衰退趋势。
• 定位外链流失风险：结合 lost_backlinks、lost_referring_domains 和 broken_pages，发现外链异常流失或承接页面失效问题。
• 评估品牌或竞品 SEO 声量：对比不同域名在多个时间区间的反向链接增长，判断品牌传播与站外影响力变化。
• 分析外链结构质量：基于 referring_links_attributes、referring_links_types、referring_links_platform_types 等字段，评估外链来源结构是否健康。
• 发现化链接机会：查看 referring_links_tld 与 referring_links_countries 分布，识别海外市场、语种站点或地区拓链机会。