反向链接引荐网络实时查询

POST /v3/backlinks/referring_networks/live

接口说明

该接口用于查询指定 target 的引荐网络明细指向目标的引荐 IP 或子网（subnet）概览，并返回每个网络的反向链接数量、引荐域名数量、页面数量、nofollow 分布、TLD 分布、平台类型分布等聚合指标。

请求方式：POST
接口地址：https://api.seermartech.cn/v3/backlinks/referring_networks/live

计费说明

本接口按请求计费。

参考价可根据参考单价换算，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。示例响应显示单次请求费用约为：¥0.3224 / 次

请求体格式

所有 POST 数据均应使用 UTF-8 编码的 JSON 格式提交。请求体为 JSON 数组，每个数组表示一个任务对象：

json

[
 {
 "target": "example.com"
 }
]

请求参数

字段名	类型	说明
`target`	string	要查询引荐网络的目标对象。填。可填写域名、子域名或网页 URL。域名/子域名请不要带 `https://` 和 `www.`；网页使用完整绝对 URL（ `http://` 或 `https://`）。
`network_address_type`	string	要返回的网络类型。可选值：`ip`、`subnet`。默认值：`ip`。
`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	指定返回并参与统计的反向链接状态。可选值：`all`、`live`、`lost`。默认值：`live`。：`all` 表示反向链接；`live` 表示最近一次检测仍存在的反向链接；`lost` 表示已丢失的反向链接。
`filters`	array	结果过滤条件。可选。最多支持 8 个过滤条件，条件之间需使用逻辑运算符 `and` 或 `or` 连接。支持运算符：`regex`、`not_regex`、`=`、`<>`、`in`、`not_in`、`like`、`not_like`、`ilike`、`not_ilike`、`match`、`not_match`。使用 `like` / `not_like` 时可合 `%` 匹任意长度字符串。可用字段列表请参考文档中的过滤字段定义。
`order_by`	array	排序规则。可选。可使用与 `filters` 相同的字段进行排序，排序方式为 `asc` 或 `desc`，写法示例：`"rank,desc"`。单次请求最多支持 3 条排序规则。
`backlinks_filters`	array	用于过滤参与聚合统计的原始反向链接数据集。可选。支持使用反向链接明细接口中的字段作为过滤条件。例如统计 `dofollow` 链接。
`include_subdomains`	boolean	是否将 `target` 的子域名一并纳查询。默认值：`true`。若设为 `false`，则忽略子域名。
`include_indirect_links`	boolean	是否间接链接。默认值：`true`。若设为 `true`，将统计指向跳转页或 canonical 页面的间接链接；若设为 `false`，则忽略此类链接。
`exclude_internal_backlinks`	boolean	是否排除来自 `target` 子域名的反向链接。默认值：`true`。若设为 `false`，则不排除来自目标子域名的链接。
`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` 示例

以下示例表示：

保留 backlinks > 100 的网络
并且 network_address 匹指定模式

json

[
 ["backlinks", ">", 100],
 "and",
 ["network_address", "like", "%192.168%"]
]

`order_by` 示例

按 rank 倒序排序：

json

["rank,desc"]

多字段排序示例：

json

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

`backlinks_filters` 示例

将 dofollow 反向链接纳聚合统计：

json

[
 ["dofollow", "=", true]
]

响应结构

API 返回 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`。
`status_message`	string	任务状态信息。
`time`	string	任务执行耗时，单位秒。
`cost`	float	当前任务费用，单位 USD。
`result_count`	integer	`result` 数组中的数量。
`path`	array	请求路径。
`data`	object	与请求中提交参数一致的数据对象。
`result`	array	结果数组。

`result` 对象字段

字段名	类型	说明
`target`	string	请求中的目标对象。
`total_count`	integer	数据库中符合条件的总条数。
`items_count`	integer	`items` 数组中的返回数量。
`items`	array	引荐网络明细列表。

`items` 对象字段

字段名	类型	说明
`type`	string	素类型，固定为 `backlinks_referring_network`。
`network_address`	string	引荐子网或 IP 地址。
`rank`	integer	网络权重值，表示该引荐网络传递给 `target` 的权重。该指标基于链接数据库中的节点排序方法计算，原理类似于早期 PageRank。
`backlinks`	integer	指向 `target` 的反向链接数量。
`first_seen`	string	首次发现该反向链接的时间，UTC 格式：`yyyy-mm-dd hh:mm:ss +00:00`。例如：`2019-11-15 12:57:46 +00:00`。
`lost_date`	string	来自该域的最后一个反向链接丢失时间。通常表示爬虫访问页面时返回 4xx / 5xx，或最后一个链接已被移除。UTC 格式：`yyyy-mm-dd hh:mm:ss +00:00`。
`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 链接的引荐页面数量。

请求示例

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"
}

data = [
 {
 "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, json=data, headers=headers)
result = response.json
print(result)

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 target: "backlinko.com",
 network_address_type: "subnet",
 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_networks/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

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": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.6123 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": 1234,
 "items_count": 5,
 "items": [
 {
 "type": "backlinks_referring_network",
 "network_address": "192.168.1.0/24",
 "rank": 845,
 "backlinks": 320,
 "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": 30,
 "referring_main_domains_nofollow": 5,
 "referring_ips": 18,
 "referring_subnets": 6,
 "referring_pages": 97,
 "referring_links_tld": {
 "com": 150,
 "org": 32
 },
 "referring_links_types": {
 "anchor": 200,
 "image": 15
 },
 "referring_links_attributes": {
 "dofollow": 280,
 "nofollow": 40
 },
 "referring_links_platform_types": {
 "blogs": 120,
 "news": 25
 },
 "referring_links_semantic_locations": {
 "article": 85,
 "section": 20
 },
 "referring_links_countries": {
 "US": 140,
 "GB": 30
 },
 "referring_pages_nofollow": 12
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整个请求的处理状态
tasks[].status_code 表示任务状态
完整错误码及说明请参考：/v3/appendix/errors

建议至少处理以下场景：

鉴权失败
请求参数缺失或格式错误
过滤条件字段非法
排序字段限 -出 limit / internal_list_limit 最大限制
目标格式不符合要求

使用建议

查询域名或子域名时，不要带协议头和 www.
查询网页时，传完整绝对 URL
如果网络层级分布，建议将 network_address_type 设为 subnet
如果只希望统计有效外链，建议合 backlinks_filters 筛选 dofollow=true
若要排查站群或同网段集中外链，可结合 order_by=["rank,desc"] 与 filters 使用

实用场景

识别站群外链：按子网聚合查看大量外链是否集中来自少数网段，帮助判断站群、PBN 或异常引荐来源。
筛选高价值网络来源：基于 rank、backlinks、referring_domains 排序，快速定位对目标站贡献最大的引荐网络。
排查失效链接风险：结合 broken_backlinks、broken_pages、lost_date 识别正在衰退或已失效的网络来源，及时补链或修复落地页。
分析链接地域与平台结构：利用 referring_links_countries、referring_links_platform_types、referring_links_tld 评估外链来源是否符合目标市场和投放策略。
构建精细化外链画像：通过 backlinks_filters 与 filters 统计 dofollow、特定类型或特定规模的链接网络，为竞品分析和外链审计提供更可控的数据集。

反向链接引荐网络实时查询 ​

接口说明 ​

计费说明 ​

请求体格式 ​

请求参数 ​

过滤与排序说明 ​

filters 示例 ​

order_by 示例 ​

backlinks_filters 示例 ​

响应结构 ​

顶层字段 ​

tasks 对象字段 ​

result 对象字段 ​

items 对象字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​

实用场景 ​

反向链接引荐网络实时查询

接口说明

计费说明

请求体格式

请求参数

过滤与排序说明

`filters` 示例

`order_by` 示例

`backlinks_filters` 示例

响应结构

顶层字段

`tasks` 对象字段

`result` 对象字段

`items` 对象字段

请求示例

cURL

Python

TypeScript

响应示例

状态码与错误处理

使用建议

实用场景