反向链接引用域名（Live）

POST /v3/backlinks/referring_domains/live

接口说明

POST /v3/backlinks/referring_domains/live

本接口用于查询指向指定目标的引用域名，并返回引用域名数量、反向链接数量、域名排名、链接类型、国家分布及链接质量等详细指标。

请求体使用 UTF-8 编码的 JSON 数组格式。每次 Live 请求支持一个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准，同时进行的请求数最多为 30 个。

计费说明

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

请求参数

参数	类型	说明
`target`	string	填。要查询引用域名的域名、子域名或网页。<br><br>域名或子域名不得 `https://` 和 `www.`；网页使用完整 URL `http://` 或 `https://`。
`limit`	integer	返回的最大引用域名数量。可选，默认值为 `100`，最大值为 `1000`。
`offset`	integer	结果数组的偏移量。可选，默认值为 `0`。例如设置为 `10` 时，将跳过前 10 条结果，用于分页查询。
`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	指定参与返回结果和聚合指标计算的反向链接状态。可选值：<br><br>`all`：返回并统计反向链接；<br>`live`：返回并统计最近一次检查时仍有效的反向链接；<br>`lost`：返回并统计已丢失的反向链接。<br><br>默认值为 `live`。
`filters`	array	结果过滤条件。可选，最多设置 8 个过滤条件。多个条件之间使用逻辑运算符 `and` 或 `or`。<br><br>支持的运算符：`regex`、`not_regex`、`=`、`<>`、`in`、`not_in`、`like`、`not_like`、`match`、`not_match`。<br><br>`like` 和 `not_like` 支持使用 `%` 匹零个或多个字符。
`order_by`	array	结果排序规则。可使用与 `filters` 相同的字段，并指定 `asc` 或 `desc` 排序方向。单次请求最多设置 3 条排序规则。
`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` 的计算及展示范围。可选值：<br><br>`one_hundred`：0–100；<br>`one_thousand`：0–1000。<br><br>默认值为 `one_thousand`。
`tag`	string	用户自定义任务标识，最长 255 个字符。可用于识别任务并与响应结果匹。设置的值会原样返回在响应的 `data` 对象中。

过滤条件格式

过滤条件通常使用以下数组结构：

json

[
  ["backlinks", ">", 100],
  "and",
  ["domain", "like", "%example%"]
]

排序规则格式

json

["rank,desc", "backlinks,desc"]

请求示例

curl

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/backlinks/referring_domains/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "target": "backlinko.com",
      "limit": 5,
      "order_by": ["rank,desc"],
      "exclude_internal_backlinks": true,
      "backlinks_filters": [
        ["dofollow", "=", true]
      ],
      "filters": [
        ["backlinks", ">", 100]
      ]
    }
  ]'

Python

python

import requests

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

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

payload = [
    {
        "target": "backlinko.com",
        "exclude_internal_backlinks": True,
        "backlinks_filters": [
            ["dofollow", "=", True]
        ],
        "filters": [
            ["backlinks", ">", 100]
        ],
        "order_by": ["rank,desc"],
        "limit": 5,
    }
]

response = requests.post(url, headers=headers, json=payload)
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 payload = [
  {
    target: "backlinko.com",
    limit: 5,
    order_by: ["rank,desc"],
    exclude_internal_backlinks: true,
    backlinks_filters: [
      ["dofollow", "=", true],
    ],
    filters: [
      ["backlinks", ">", 100],
    ],
  },
];

axios({
  method: "post",
  url: "https://api.seermartech.cn/v3/backlinks/referring_domains/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.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	任务结果数组。

`tasks` 字段

字段	类型	说明
`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	请求中的 `target` 值。
`total_count`	integer	数据库中符合条件的引用主域名总数。主域名及子域名按主域名合并统计，例如 `example.com` 和 `blog.example.com` 计为一个引用域名。
`items_count`	integer	`items` 数组中的数量。
`items`	array	引用域名数据数组。

`items` 字段

字段	类型	说明
`type`	string	数据类型，固定为 `backlinks_referring_domain`。
`domain`	string	引用域名。
`rank`	integer	域名排名，表示引用网站向目标传递的排名权重。该指标基于链接数据库中的节点排名方法计算，原理类似于 PageRank。
`backlinks`	integer	指向目标的反向链接数量。
`first_seen`	string	爬虫首次发现该反向链接的时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。例如：`2019-11-15 12:57:46 +00:00`。
`lost_date`	string	该域名最后一个反向链接丢失的时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。当爬虫访问页面返回 4xx 或 5xx，或最后一个反向链接被移除时，会记录该时间。
`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	指向目标的页面数量。
`referring_links_tld`	object	引用链接的顶级域名分布，顶级域名及对应的引用链接数量。
`referring_links_types`	object	引用链接类型分布及各类型链接数量。可能的类型：`anchor`、`image`、`link`、`meta`、`canonical`、`alternate`、`redirect`。
`referring_links_attributes`	object	引用链接属性分布及各属性链接数量。
`referring_links_platform_types`	object	引用平台类型分布及链接数量。可能的类型：`cms`、`blogs`、`ecommerce`、`message-boards`、`wikis`、`news`、`organization`。
`referring_links_semantic_locations`	object	引用链接所在 HTML 语义位置及链接数量，例如 `article`、`section`、`summary`。
`referring_links_countries`	object	引用链接所在域名的 ISO 国家代码及链接数量。
`referring_pages_nofollow`	integer	至少一个 `nofollow` 链接指向目标的引用页面数量。

响应示例

json

{
  "version": "0.1.20230825",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.8296 sec.",
  "cost": 0.02015,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " ಕೆc1c7c0f-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.7012 sec.",
      "cost": 0.02015,
      "result_count": 1,
      "path": [
        "v3",
        "backlinks",
        "referring_domains",
        "live"
      ],
      "data": {
        "api": "backlinks",
        "function": "referring_domains",
        "target": "backlinko.com",
        "limit": 5,
        "order_by": [
          "rank,desc"
        ],
        "exclude_internal_backlinks": true,
        "backlinks_filters": [
          [
            "dofollow",
            "=",
            true
          ]
        ],
        "filters": [
          [
            "backlinks",
            ">",
            100
          ]
        ]
      },
      "result": [
        {
          "target": "backlinko.com",
          "total_count": 1250,
          "items_count": 1,
          "items": [
            {
              "type": "backlinks_referring_domain",
              "domain": "example.com",
              "rank": 742,
              "backlinks": 128,
              "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": 4,
              "referring_domains_nofollow": 1,
              "referring_main_domains": 1,
              "referring_main_domains_nofollow": 1,
              "referring_ips": 3,
              "referring_subnets": 2,
              "referring_pages": 96,
              "referring_links_tld": {
                "com": 128
              },
              "referring_links_types": {
                "anchor": 120,
                "image": 8
              },
              "referring_links_attributes": {
                "dofollow": 118,
                "nofollow": 10
              },
              "referring_links_platform_types": {
                "cms": 100,
                "blogs": 28
              },
              "referring_links_semantic_locations": {
                "article": 90,
                "section": 38
              },
              "referring_links_countries": {
                "US": 100,
                "GB": 28
              },
              "referring_pages_nofollow": 7
            }
          ]
        }
      ]
    }
  ]
}

> 示例中的 id、统计数据及费用用于展示字段结构，返回以接口响应为准。

状态码与异常处理

接口会在顶层和任务级别返回 status_code 与 status_message。除判断 HTTP 状态外，客户端还应检查任务级别状态码，并针对请求失败、参数错误、数据为空及服务异常等设计重试或错误处理机制。

实用场景

盘点竞争对手的引用域名，识别主要外链来源，为外链拓展和竞品策略分析提供依据。
筛选高质量引用域名，结合 rank、backlinks 和 backlinks_spam_score 评估外链资源质量，降低低质链接建设风险。
分析行业外链结构，按顶级域名、国家、平台类型和语义位置拆分引用链接，发现适合投放或合作的渠道。
监控外链流失，通过 lost_date、lost_date 和 lost 状态筛选丢失链接，及时定位排名或流量下降原因。
构建可控的外链数据集，使用 backlinks_filters、filters 和 exclude_internal_backlinks 排除链接及低价值链接，生成更准确的 SEO 评估指标。

反向链接引用域名（Live） ​

接口说明 ​

计费说明 ​

请求参数 ​

过滤条件格式 ​

排序规则格式 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

tasks 字段 ​

result 字段 ​

items 字段 ​

响应示例 ​

状态码与异常处理 ​

实用场景 ​

反向链接引用域名（Live）

接口说明

计费说明

请求参数

过滤条件格式

排序规则格式

请求示例

curl

Python

TypeScript

响应结构

顶层字段

`tasks` 字段

`result` 字段

`items` 字段

响应示例

状态码与异常处理

实用场景