反向链接历史数据（实时）

POST /v3/backlinks/history/live

接口说明

本接口使用 POST 方法，路径为：

text

/v3/backlinks/history/live

完整请求地址：

text

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

本接口用于查询域名的历史反向链接数据，数据最早可追溯至 2019-01-01。接口按月返回指定时间范围的数据反向链接总数、新增与丢失的反向链接、引用域名、抓取页面等指标。

请求方法：POST
请求体格式：application/json
每个实时请求只能 1 个任务平台限流以认证说明中的 30/60/120 次/分钟规则为准
同时进行的请求最多为 30 个
历史数据起始日期：2019-01-01

计费说明

每次请求均会产生费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

请求体为 JSON 数组：

json

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

任务参数

参数	类型	填	说明
`target`	string	是	要查询的域名。请勿 `https://` 或 `www.`，例如 `example.com`。
`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` 对象中返回。

`rank_scale` 可选值

值	说明
`one_hundred`	将排名指标按 0–100 的范围展示。
`one_thousand`	将排名指标按 0–1000 的范围展示，默认值。

请求示例

cURL

bash

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",
      "rank_scale": "one_thousand",
      "tag": "competitor-history-001"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/backlinks/history/live"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

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

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

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，状态码：{}，消息：{}".format(
            result.get("status_code"),
            result.get("status_message"),
        )
    )

TypeScript

typescript

import axios from "axios";

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

axios
  .post(
    "https://api.seermartech.cn/v3/backlinks/history/live",
    payload,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    // 处理响应数据
    console.log(response.data);
  })
  .catch((error) => {
    // 处理请求异常
    console.error(error.response?.data || error.message);
  });

响应结构

接口返回 JSON 数据，顶层 tasks 数组。每个任务对应一个提交的查询任务。

顶层响应字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用响应状态码。成功时通常为 `20000`。
`status_message`	string	通用状态说明。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务结果数组。

任务字段

字段	类型	说明
`id`	string	任务唯一标识，采用 UUID 格式。
`status_code`	integer	当前任务的状态码，通常在 `10000`–`60000` 范围。
`status_message`	string	当前任务的状态说明。
`time`	string	任务执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`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` 字段

字段	类型	说明
`type`	string	数据类型，固定为 `backlinks_history`。
`date`	string	目标数据的存储时间，UTC 格式为 `yyyy-mm-dd hh-mm-ss +00:00`。
`rank`	integer	指定日期的域名排名指标。取值范围受 `rank_scale` 影响。
`backlinks`	integer	反向链接总数。
`new_backlinks`	integer	新增反向链接数量，与上一统计周期进行比较。该字段从 2021 年 5 月开始提供；如果查询范围早于 2021 年 5 月，则返回 `0`。
`lost_backlinks`	integer	丢失反向链接数量，与上一统计周期进行比较。该字段从 2021 年 5 月开始提供；如果查询范围早于 2021 年 5 月，则返回 `0`。
`new_referring_domains`	integer	新增引用域名数量，与上一统计周期进行比较。该字段从 2021 年 5 月开始提供；如果查询范围早于 2021 年 5 月，则返回 `0`。
`lost_referring_domains`	integer	丢失引用域名数量，与上一统计周期进行比较。该字段从 2021 年 5 月开始提供；如果查询范围早于 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	至少向目标提供一个 `nofollow` 链接的域名数量。
`referring_main_domains`	integer	引用主域名数量。
`referring_main_domains_nofollow`	integer	至少向目标提供一个 `nofollow` 链接的主域名数量。
`referring_ips`	integer	引用 IP 地址数量，即指向目标的 IP 地址数量。
`referring_subnets`	integer	引用子网数量。
`referring_pages`	integer	指向目标的页面数量。
`referring_links_tld`	object	引用链接的顶级域名分布。对象的键为顶级域名，值为对应的引用链接数量。
`referring_links_types`	object	引用链接类型及数量。可能的类型：`anchor`、`image`、`link`、`meta`、`canonical`、`alternate`、`redirect`。
`referring_links_attributes`	object	引用链接属性及数量，例如 `nofollow`、`noopener`、`noreferrer`、`external`、`ugc`、`bookmark`、`alternate`、`author`、`tag`、`sponsored`。
`referring_links_platform_types`	object	引用平台类型及链接数量。可能的类型：`cms`、`blogs`、`ecommerce`、`message-boards`、`wikis`、`news`、`organization`。
`referring_links_semantic_locations`	object	引用链接所在 HTML 语义位置及数量，例如 `article`、`section`、`summary`、`header`、`footer`、`nav` 等。
`referring_links_countries`	object	引用链接所在域名的 ISO 国家代码及链接数量。无数据时可能为 `null`。
`referring_pages_nofollow`	integer	至少一个指向目标的 `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	目标垃圾链接评分。如果目标为域名或子域名，则表示该域名或子域名所有页面的平均垃圾评分。

响应示例

json

{
  "version": "0.1.20230825",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1571 sec.",
  "cost": 0.02012,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " ಇನ್ನ-示例任务ID",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1200 sec.",
      "cost": 0.02012,
      "result_count": 1,
      "path": [
        "v3",
        "backlinks",
        "history",
        "live"
      ],
      "data": {
        "target": "ibm.com",
        "date_from": "2020-08-01",
        "date_to": "2021-01-01"
      },
      "result": [
        {
          "target": "ibm.com",
          "date_from": "2020-08-01",
          "date_to": "2021-01-01",
          "items_count": 3,
          "items": [
            {
              "type": "backlinks_history",
              "date": "2020-08-31 00:00:00 +00:00",
              "rank": 601,
              "backlinks": 8223340,
              "new_backlinks": 423100,
              "lost_backlinks": 149820,
              "new_referring_domains": 4310,
              "lost_referring_domains": 372,
              "crawled_pages": 2378120,
              "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": 48306246,
              "external_links_count": 6814735,
              "broken_backlinks": 0,
              "broken_pages": 153405,
              "referring_domains": 196837,
              "referring_domains_nofollow": 4730,
              "referring_main_domains": 150753,
              "referring_main_domains_nofollow": 3635,
              "referring_ips": 98439,
              "referring_subnets": 55945,
              "referring_pages": 7523423,
              "referring_links_tld": {
                "com": 3649487,
                "org": 1011765,
                "net": 355506
              },
              "referring_links_types": {
                "anchor": 7462829,
                "redirect": 58950,
                "canonical": 1626,
                "alternate": 18
              },
              "referring_links_attributes": {
                "nofollow": 971813,
                "noopener": 748692,
                "noreferrer": 154975,
                "sponsored": 116
              },
              "referring_links_platform_types": {
                "unknown": 6630888,
                "cms": 737977,
                "blogs": 673558,
                "wikis": 39589
              },
              "referring_links_semantic_locations": {
                "footer": 1935941,
                "section": 986991,
                "article": 445547,
                "header": 120263
              },
              "referring_links_countries": null,
              "referring_pages_nofollow": 36250
            }
          ]
        }
      ]
    }
  ]
}

状态码与错误处理

请根据顶层 status_code 和任务级 status_code 判断请求及任务是否成功：

20000：请求或任务成功。
状态码：请求或任务失败，应结合对应的 status_message 排查原因。

建议客户端对网络异常、鉴权失败、参数校验失败、频率限制和服务端错误进行统一处理，并根据需要执行重试或记录失败任务。

实用场景

对比竞品域名的月度反向链接增长与流失趋势，评估竞争对手的外链建设节奏和策略变化。
监控目标站点的新增及丢失反向链接，及时发现外链异常波动并定位潜在的 SEO 风险。
统计引用域名、引用 IP、引用子网和引用页面数量，评估外链来源的广度与集中度。
分析引用链接的国家、顶级域名、平台类型和语义位置，为外链拓展和合作筛选优渠道。
评估失效反向链接、失效页面及外部链接数量，支持站点链接健康度审计和修复优级排序。

反向链接历史数据（实时） ​

接口说明 ​

计费说明 ​

请求参数 ​

任务参数 ​

rank_scale 可选值 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层响应字段 ​

任务字段 ​

result 字段 ​

items 字段 ​

info 字段 ​

响应示例 ​

状态码与错误处理 ​

实用场景 ​