域名页面反向链接摘要（实时）

POST /v3/backlinks/domain_pages_summary/live

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

/v3/backlinks/domain_pages_summary/live

用于获取指定域名、子域名或页面下各页面的反向链接汇总数据及指标。如果将单个页面作为目标，则返回该页面的反向链接摘要数据。

请求说明

请求方法：POST
请求地址：https://api.seermartech.cn/v3/backlinks/domain_pages_summary/live
请求体格式：UTF-8 编码的 JSON 数组
单次实时请求最多 1 个任务平台限流以认证说明中的 30/60/120 次/分钟规则为准
同时发送的请求数最多为 30 个

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

请求参数

请求体是 JSON 数组，每个数组代表一个任务。

参数	类型	填	说明
`target`	string	是	要获取摘要数据的域名、子域名或页面。域名和子域名不得 `https://` 与 `www.`；页面使用 `http://` 或 `https://` 的完整 URL。
`limit`	integer	否	返回的最大页面数量。默认值：`100`；最大值：`1000`。
`offset`	integer	否	结果数组的偏移量。默认值：`0`。例如设置为 `10` 时，跳过前 10 条结果，从第 11 条开始返回。
`internal_list_limit`	integer	否	限制数组的最大数量。适用于 `referring_links_tld`、`referring_links_types`、`referring_links_attributes`、`referring_links_platform_types`、`referring_links_semantic_locations`。默认值：`10`；最大值：`1000`。
`backlinks_status_type`	string	否	指定参与返回和统计的反向链接类型。可选值：`all`（）、`live`（当前有效）、`lost`（已丢失）。默认值：`live`。
`filters`	array	否	结果过滤条件。最多设置 8 个过滤条件，条件之间需使用 `and` 或 `or` 连接。
`order_by`	array	否	结果排序规则。最多设置 3 条排序规则，支持 `asc`（升序）和 `desc`（降序）。
`backlinks_filters`	array	否	过滤用于计算目标汇总指标的初始反向链接。可使用反向链接明细接口返回的字段进行过滤，例如统计 `dofollow` 链接。
`include_subdomains`	boolean	否	是否在搜索中目标域名的子域名。`false` 表示忽略子域名。默认值：`true`。
`include_indirect_links`	boolean	否	是否指向目标的间接链接。`true` 表示指向重定向页面或规范页面的链接；`false` 表示忽略。默认值：`true`。
`exclude_internal_backlinks`	boolean	否	是否排除来自目标域名子域名的反向链接。默认值：`true`。
`rank_scale`	string	否	指定 `rank`、`domain_from_rank` 和 `page_from_rank` 的计算及展示范围。可选值：`one_hundred`（0–100）和 `one_thousand`（0–1000）。默认值：`one_thousand`。
`tag`	string	否	自定义任务标识，用于请求与响应。最大长度为 255 个字符，设置后会原样返回在响应的 `data` 对象中。

`filters` 过滤器

支持的运算符：

regex、not_regex
=、<>
in、not_in
like、not_like
ilike、not_ilike
match、not_match

使用 like 或 not_like 时，可以使用 % 匹零个或多个字符。

示例：

json

"filters": [
  ["url", "like", "%/blog/%"],
  "and",
  ["backlinks", ">", 10]
]

`order_by` 排序

排序字段可使用结果中的字段，排序方向通过逗号指定：

json

"order_by": [
  "backlinks,desc",
  "rank,desc"
]

单次请求最多设置 3 条排序规则。

`backlinks_filters` 示例

以下示例表示使用 dofollow 反向链接参与统计：

json

"backlinks_filters": [
  ["dofollow", "=", true]
]

请求示例

curl

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/backlinks/domain_pages_summary/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "target": "forbes.com",
      "limit": 4,
      "backlinks_status_type": "live",
      "order_by": [
        "backlinks,desc"
      ]
    }
  ]'

Python

python

import requests

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

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

post_data = [
    {
        "target": "forbes.com",
        "limit": 4,
        "backlinks_status_type": "live",
        "order_by": ["backlinks,desc"],
    }
]

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

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败。错误码：%s，错误信息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

const postData = [
  {
    target: "forbes.com",
    limit: 4,
    backlinks_status_type: "live",
    order_by: ["backlinks,desc"],
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/backlinks/domain_pages_summary/live",
    postData,
    {
      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	请求中的目标对象。
`total_count`	integer	数据库中符合条件的项目总数。
`items_count`	integer	当前返回的项目数量。
`items`	array	页面摘要数据数组。

`items` 字段

字段	类型	说明
`type`	string	数据类型，固定为 `backlinks_page_summary`。
`url`	string	页面 URL。
`rank`	integer	页面排名值。该值根据链接数据库中的节点排名方法计算。取值范围由 `rank_scale` 决定。
`backlinks`	integer	指向该页面的反向链接数量。
`first_seen`	string	爬虫首次发现指向该页面的反向链接的时间。UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`lost_date`	string	最近一次丢失指向该页面的反向链接的时间。通常表示页面返回 4xx/5xx 状态码，或链接已被移除。UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`backlinks_spam_score`	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 地址数量。
`referring_subnets`	integer	指向该页面的来源子网数量。
`referring_pages`	integer	指向目标 URL 的来源页面数量。
`referring_links_tld`	object	来源链接的顶级域名分布及各自链接数量。
`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	至少一个 `nofollow` 链接指向该页面的来源页面数量。

`referring_links_types` 可选值

值	说明
`anchor`	锚文本链接
`image`	图片链接
`link`	普通链接
`meta`	Meta 链接
`canonical`	规范链接
`alternate`	备用链接
`redirect`	重定向链接

`referring_links_platform_types` 可选值

cms：管理系统
blogs：博客
ecommerce：电子商务
message-boards：留言板或论坛
wikis：Wiki
news：新闻网站
organization：组织或机构网站

`referring_links_semantic_locations` 示例

该字段表示链接所在的 HTML 语义区域，例如：

article
section
footer

响应示例

json

{
  "version": "0.1.20230825",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "1.8813 sec.",
  "cost": 0.02012,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "1.8813 sec.",
      "cost": 0.02012,
      "result_count": 1,
      "path": [
        "v3",
        "backlinks",
        "domain_pages_summary",
        "live"
      ],
      "data": {
        "api": "backlinks",
        "function": "domain_pages_summary",
        "target": "forbes.com",
        "limit": 4,
        "backlinks_status_type": "live",
        "order_by": [
          "backlinks,desc"
        ]
      },
      "result": [
        {
          "target": "forbes.com",
          "total_count": 100,
          "items_count": 1,
          "items": [
            {
              "type": "backlinks_page_summary",
              "url": "https://forbes.com/example-page",
              "rank": 742,
              "backlinks": 125,
              "first_seen": "2019-11-15 12:57:46 +00:00",
              "lost_date": null,
              "backlinks_spam_score": 3,
              "broken_backlinks": 2,
              "broken_pages": 1,
              "referring_domains": 48,
              "referring_domains_nofollow": 12,
              "referring_main_domains": 42,
              "referring_main_domains_nofollow": 10,
              "referring_ips": 39,
              "referring_subnets": 35,
              "referring_pages": 87,
              "referring_links_tld": {
                "com": 80,
                "org": 25,
                "net": 20
              },
              "referring_links_types": {
                "anchor": 110,
                "image": 10,
                "redirect": 5
              },
              "referring_links_attributes": {
                "dofollow": 100,
                "nofollow": 25
              },
              "referring_links_platform_types": {
                "cms": 70,
                "blogs": 35,
                "news": 20
              },
              "referring_links_semantic_locations": {
                "article": 80,
                "section": 30,
                "footer": 15
              },
              "referring_links_countries": {
                "US": 60,
                "GB": 25,
                "CA": 15
              },
              "referring_pages_nofollow": 18
            }
          ]
        }
      ]
    }
  ]
}

状态码与错误处理

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

20000：请求成功
状态码：请求或任务处理失败

建议客户端同时检查：

HTTP 状态码；
顶层 status_code；
tasks[*].status_code；
tasks_error 是否大于 0。

发生错误时，应记录 status_code、status_message、任务 id 及原始请求参数，便于重试和问题排查。

实用场景

盘点目标域名的页面级反向链接，识别哪些页面获得了最多外部链接，为资产评估和链接规划提供依据。
筛选高反向链接数量但排名较低的页面，定位需要优化页面质量、性或站链接结构的重点对象。
监测页面失效反向链接与失效来源页面，及时修复 4xx/5xx 页面，减少链接资产流失。
分析来源域名、国家、平台和 HTML 语义位置分布，评估外链渠道质量并指导推广和外链建设。
通过 backlinks_filters 对 dofollow、nofollow 或链接属性进行分层统计，比较不同类型外链对页面链接表现的贡献。

域名页面反向链接摘要（实时） ​

请求说明 ​

请求参数 ​

filters 过滤器 ​

order_by 排序 ​

backlinks_filters 示例 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应说明 ​

顶层响应字段 ​

任务字段 ​

result 字段 ​

items 字段 ​

referring_links_types 可选值 ​

referring_links_platform_types 可选值 ​

referring_links_semantic_locations 示例 ​

响应示例 ​

状态码与错误处理 ​

实用场景 ​

域名页面反向链接摘要（实时）

请求说明

请求参数

`filters` 过滤器

`order_by` 排序

`backlinks_filters` 示例

请求示例

curl

Python

TypeScript

响应说明

顶层响应字段

任务字段

`result` 字段

`items` 字段

`referring_links_types` 可选值

`referring_links_platform_types` 可选值

`referring_links_semantic_locations` 示例

响应示例

状态码与错误处理

实用场景