SeerMarTech API 文档

主题

引荐网络实时查询 ​

POST /v3/backlinks/referring_networks/live

接口说明 ​

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

本接口用于查询指向指定目标的引荐 IP 地址或子网，并返回引荐网络的链接数量、排名、来源域名、链接类型及地域分布等详细信息。

所有请求数据使用 UTF-8 编码的 JSON 格式。请求体是 JSON 数组，每次请求最多 1 个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准，同时并发请求数最多为 30。

计费说明 ​

每个请求按任务计费。示例响应中的任务成本 0.02015 美，按参考汇率折算约为 ¥0.145 / 次。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

请求体示例：

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

任务参数 ​

参数类型填说明
targetstring是要查询引荐网络的域名、子域名或网页。域名和子域名不得 https:// 或 www.；网页使用协议的绝对 URL，例如 https://example.com/page。
network_address_typestring否网络地址类型。可选值：ip、subnet。默认值：ip。
limitinteger否返回的最大网络数量。默认值：100，最大值：1000。
offsetinteger否结果偏移量。默认值：0。例如设置为 10 时，将跳过前 10 条结果并返回后续数据。
internal_list_limitinteger否限制数组的最大数量。适用于 referring_links_tld、referring_links_types、referring_links_attributes、referring_links_platform_types 和 referring_links_semantic_locations。默认值：10，最大值：1000。
backlinks_status_typestring否指定返回并用于聚合指标计算的反向链接状态。可选值：all（）、live（当前有效）、lost（已丢失）。默认值：live。
filtersarray否对引荐网络结果进行过滤。最多设置 8 个过滤条件，多个条件之间需要使用 and 或 or。
order_byarray否结果排序规则。排序字段可使用与 filters 相同的字段，格式为 字段,排序方向，排序方向为 asc 或 desc。单次请求最多设置 3 条排序规则。
backlinks_filtersarray否过滤目标的初始反向链接数据，这些数据将用于计算聚合指标。可使用反向链接实时查询接口响应中的字段进行过滤，例如纳 dofollow 链接。
include_subdomainsboolean否是否将目标的子域名纳查询。设置为 false 时忽略子域名。默认值：true。
include_indirect_linksboolean否是否间接指向目标的链接。设置为 true 时，将指向重定向到目标页面，或指向目标规范页面的链接。默认值：true。
exclude_internal_backlinksboolean否是否排除来自目标子域名的反向链接。默认值：true。
rank_scalestring否指定 rank、domain_from_rank 和 page_from_rank 的计算及展示范围。可选值：one_hundred（0–100）和 one_thousand（0–1000）。默认值：one_thousand。
tagstring否用户自定义任务标识，用于识别任务并匹响应结果。最大长度为 255 个字符，提交的值会在响应 data 对象中返回。

过滤器 ​

filters 和 backlinks_filters 支持以下运算符：

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

使用 like 或 not_like 时，可以使用 % 匹任意长度的字符串。

示例：

json
{
  "filters": [
    ["backlinks", ">", 100],
    "and",
    ["rank", ">=", 20]
  ],
  "backlinks_filters": [
    ["dofollow", "=", true]
  ]
}

请求示例 ​

cURL ​

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

Python ​

python
import requests

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

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

payload = [
    {
        "target": "backlinko.com",
        "network_address_type": "subnet",
        "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 response = await axios.post(
  "https://api.seermartech.cn/v3/backlinks/referring_networks/live",
  [
    {
      target: "backlinko.com",
      network_address_type: "subnet",
      exclude_internal_backlinks: true,
      backlinks_filters: [
        ["dofollow", "=", true],
      ],
      filters: [
        ["backlinks", ">", 100],
      ],
      order_by: [
        "rank,desc",
      ],
      limit: 5,
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

if (response.data.status_code === 20000) {
  console.log(response.data);
} else {
  console.error(
    `请求失败，错误码：${response.data.status_code}，消息：${response.data.status_message}`
  );
}

响应结构 ​

接口返回 JSON 对象 tasks 任务数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger请求级状态码。成功通常为 20000。完整错误码请参考错误码文档。
status_messagestring请求级状态说明。
timestring请求执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务总数。
tasks_errorinteger执行失败的任务数量。
tasksarray任务结果数组。

tasks 字段 ​

字段类型说明
idstring任务唯一标识，UUID 格式。
status_codeinteger任务状态码，通常在 10000–60000 范围。
status_messagestring任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharray请求 URL 路径。
dataobject与提交任务时使用的参数基本一致。
resultarray查询结果数组。

result 字段 ​

字段类型说明
targetstring请求中的目标对象。
total_countinteger数据库中符合条件的结果总数。
items_countintegeritems 数组中的数量。
itemsarray引荐网络数据列表。

items 字段 ​

字段类型说明
typestring结果类型，固定为 backlinks_referring_network。
network_addressstring引荐子网或 IP 地址。
rankinteger引荐网络排名，表示该网络向目标传递的排名权重。默认使用 0–1000 范围，可通过 rank_scale 调整为 0–100。
backlinksinteger指向目标的反向链接数量。
first_seenstring爬虫首次发现该反向链接的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。例如：2019-11-15 12:57:46 +00:00。
lost_datestring该来源域名最近一次丢失反向链接的时间。通常表示来源页面返回 4xx/5xx 状态码，或链接已被移除。使用 UTC 格式。
broken_backlinksinteger指向目标的失效反向链接数量。
broken_pagesinteger存在反向链接且返回 4xx/5xx 状态码的页面数量。
referring_domainsinteger引荐域名数量。子域名会按独立域名分别统计。
referring_domains_nofollowinteger至少一个 nofollow 链接指向目标的引荐域名数量。
referring_main_domainsinteger引荐主域名数量。
referring_main_domains_nofollowinteger至少一个 nofollow 链接指向目标的引荐主域名数量。
referring_ipsinteger指向目标的引荐 IP 地址数量。
referring_subnetsinteger引荐子网数量。
referring_pagesinteger指向目标的引荐页面数量。
referring_links_tldobject引荐链接的顶级域名分布，以及每个顶级域名对应的链接数量。
referring_links_typesobject引荐链接类型及对应数量。可能的类型 anchor、image、link、meta、canonical、alternate 和 redirect。
referring_links_attributesobject引荐链接属性及对应数量。
referring_links_platform_typesobject引荐平台类型及对应数量。可能的类型 cms、blogs、ecommerce、message-boards、wikis、news 和 organization。
referring_links_semantic_locationsobject引荐链接所在 HTML 语义位置及对应数量，例如 article、section 和 summary。
referring_links_countriesobject引荐链接来源国家或地区的 ISO 代码及对应链接数量。
referring_pages_nofollowinteger至少一个 nofollow 链接指向目标的引荐页面数量。

响应示例 ​

json
{
  "version": "0.1.20230825",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.6976 sec.",
  "cost": 0.02015,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.5123 sec.",
      "cost": 0.02015,
      "result_count": 1,
      "path": [
        "v3",
        "backlinks",
        "referring_networks",
        "live"
      ],
      "data": {
        "api": "backlinks",
        "function": "referring_networks",
        "target": "backlinko.com",
        "network_address_type": "subnet",
        "limit": 5,
        "order_by": [
          "rank,desc"
        ],
        "exclude_internal_backlinks": true,
        "backlinks_filters": [
          ["dofollow", "=", true]
        ],
        "filters": [
          ["backlinks", ">", 100]
        ]
      },
      "result": [
        {
          "target": "backlinko.com",
          "total_count": 125,
          "items_count": 1,
          "items": [
            {
              "type": "backlinks_referring_network",
              "network_address": "192.0.2.0/24",
              "rank": 842,
              "backlinks": 318,
              "first_seen": "2019-11-15 12:57:46 +00:00",
              "lost_date": null,
              "broken_backlinks": 2,
              "broken_pages": 1,
              "referring_domains": 42,
              "referring_domains_nofollow": 8,
              "referring_main_domains": 35,
              "referring_main_domains_nofollow": 6,
              "referring_ips": 18,
              "referring_subnets": 4,
              "referring_pages": 96,
              "referring_links_tld": {
                "com": 240,
                "org": 52,
                "net": 26
              },
              "referring_links_types": {
                "anchor": 280,
                "image": 38
              },
              "referring_links_attributes": {
                "dofollow": 318
              },
              "referring_links_platform_types": {
                "cms": 210,
                "news": 58
              },
              "referring_links_semantic_locations": {
                "article": 190,
                "section": 72
              },
              "referring_links_countries": {
                "US": 180,
                "GB": 64
              },
              "referring_pages_nofollow": 12
            }
          ]
        }
      ]
    }
  ]
}

请求或任务发生异常时，应根据 status_code 和 status_message 进行错误处理，并为异常设计重试、告警或降级机制。完整错误码请参考错误码文档。

实用场景 ​

  • 识别高价值引荐子网：按 rank 和 backlinks 排序，定位集中产生高质量外链的 IP 段，优化外链拓展与合作名单。
  • 排查外链网络风险：统计来自同一子网的域名和链接数量，发现异常集中、疑似站群或低质量链接来源。
  • 分析竞争对手的外链结构：对竞争域名查询引荐网络，比较来源 IP、子网、国家和顶级域名分布，制定差异化外链策略。
  • 监控外链丢失：使用 backlinks_status_type、lost_date 和 broken_backlinks，定位已丢失或失效链接，支持外链恢复。
  • 筛选可传递权重的链接来源：通过 backlinks_filters 保留 dofollow 链接，评估不同引荐网络对目标页面权重和排名的潜在贡献。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API