反向链接域名页面汇总（实时）

接口说明

该接口用于按页面维度汇总指定目标的反向链接数据与指标。

如果 target 是域名或子域名，返回该目标下各页面的反向链接汇总信息；
如果 target 是单个页面 URL，返回该页面的完整反向链接汇总信息。

请求地址

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

计费说明

该接口按请求计费。

参考价：扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求格式

请求方法：POST
请求体：JSON 数组 [{ ... }]
编码：UTF-8
Content-Type：application/json

请求参数

字段名	类型	说明
`target`	string	填。需要查询汇总数据的目标域名、子域名或页面。域名/子域名请不要 `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	可选。指定返回并参与聚合统计的反向链接状态。可选值：`all`、`live`（最近一次检查中仍然存在的链接）、`lost`（已丢失链接）。默认 `live`。
`filters`	array	可选。结果过滤条件数组，最多支持 `8` 个过滤条件。条件之间需使用逻辑运算符 `and` 或 `or` 连接。支持操作符：`regex`、`not_regex`、`=`、`<>`、`in`、`not_in`、`like`、`not_like`、`ilike`、`not_ilike`、`match`、`not_match`。使用 `like`/`not_like` 时可通过 `%` 匹任意长度字符串。完整可过滤字段参考 `/v3/backlinks/filters/`。
`order_by`	array	可选。排序规则。可使用与 `filters` 相同的字段作为排序字段，排序方式支持 `asc` 和 `desc`。单次请求最多支持 `3` 条排序规则。
`backlinks_filters`	array	可选。对参与聚合计算的原始反向链接数据集进行过滤。可基于 `/v3/backlinks/backlinks/live/` 响应中的字段进行过滤。例如纳 dofollow 反向链接进行统计。
`include_subdomains`	boolean	可选。是否在查询中 `target` 域名的子域名。默认 `true`。若设为 `false`，将忽略子域名。
`include_indirect_links`	boolean	可选。是否间接指向 `target` 的链接。默认 `true`。为 `true` 时，会指向重定向页或 canonical 页的链接；为 `false` 时忽略此类链接。
`exclude_internal_backlinks`	boolean	可选。是否排除来自目标子域名的反向链接。默认 `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 参数说明

filters 用于过滤返回结果中的页面汇总项，支持组合多个条件。

支持的逻辑连接符

and
or

支持的比较操作符

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

示例

筛选反向链接数较高且引荐域名数大于 10 的页面：

json

[
 {
 "target": "forbes.com",
 "filters": [
 ["backlinks", ">", 100],
 "and",
 ["referring_domains", ">", 10]
 ]
 }
]

说明：完整可过滤字段请参考容路径 /v3/backlinks/filters/。

order_by 参数说明

order_by 用于指定结果排序规则，最多支持 3 条。

示例

按反向链接数降序，再按引荐域名数降序：

json

[
 {
 "target": "forbes.com",
 "limit": 4,
 "order_by": ["backlinks,desc", "referring_domains,desc"]
 }
]

backlinks_filters 参数说明

backlinks_filters 用于过滤参与统计计算的原始反向链接集合，而是最终返回结果。

例如：统计 dofollow 反向链接。

json

[
 {
 "target": "forbes.com",
 "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,
 "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"
}
data = [
 {
 "target": "forbes.com",
 "limit": 4,
 "order_by": ["backlinks,desc"]
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

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

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/domain_pages_summary/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 数据，顶层 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`。完整错误码参考 `/v3/appendix/errors`。
`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`	array	页面汇总结果列表。

items字段

字段名	类型	说明
`type`	string	素类型，固定为 `backlinks_page_summary`。
`url`	string	页面 URL。
`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	最后一个反向链接丢失的时间。通常表示爬虫访问页面时发现返回 4xx/5xx，或最后一个链接已被移除。UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2017-01-24 13:20:59 +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	指向该页面的引荐页面数量。
`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`、`footer`。
`referring_links_countries`	object	引荐链接所在域名的 ISO 国家代码分布及对应链接数。
`referring_pages_nofollow`	integer	至少向该页面提供一个 nofollow 链接的引荐页面数量。

响应示例

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": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.8123 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,
 "order_by": ["backlinks,desc"]
 },
 "result": [
 {
 "target": "forbes.com",
 "total_count": 245678,
 "items_count": 4,
 "items": [
 {
 "type": "backlinks_page_summary",
 "url": "https://www.forbes.com/example-page-1/",
 "rank": 542,
 "backlinks": 1820,
 "first_seen": "2019-11-15 12:57:46 +00:00",
 "lost_date": null,
 "backlinks_spam_score": 12,
 "broken_backlinks": 3,
 "broken_pages": 0,
 "referring_domains": 246,
 "referring_domains_nofollow": 31,
 "referring_main_domains": 198,
 "referring_main_domains_nofollow": 25,
 "referring_ips": 205,
 "referring_subnets": 176,
 "referring_pages": 640,
 "referring_links_tld": {
 "com": 1100,
 "org": 220
 },
 "referring_links_types": {
 "anchor": 1500,
 "image": 120
 },
 "referring_links_attributes": {
 "nofollow": 180,
 "ugc": 25
 },
 "referring_links_platform_types": {
 "news": 430,
 "blogs": 290
 },
 "referring_links_semantic_locations": {
 "article": 510,
 "footer": 88
 },
 "referring_links_countries": {
 "US": 920,
 "GB": 140
 },
 "referring_pages_nofollow": 96
 }
 ]
 }
 ]
 }
 ]
}

错误处理

建议重点处理以下两类状态：

顶层 status_code：判断整个请求是否成功；
tasks[].status_code：判断任务是否成功。

完整错误码与状态信息可参考容路径：

/v3/appendix/errors

常见处理建议：

当顶层 status_code 非成功状态时，直接按请求失败处理；
当顶层成功但 tasks_error > 0 时，逐个检查 tasks 中的任务状态；
当分页请求使用较大的 offset 或复杂过滤条件时，建议记录原始请求参数，便于排查结果为空或数量异常的问题。

使用建议

查询整个域名时，建议结合 limit、offset 分页获取结果；
如需只分析有效链接，优结合 backlinks_status_type=live；
如需构建更精确的数据集，建议使用 backlinks_filters 保留指定属性的链接，如 dofollow、特定平台类型或特定国家来源；
如需统一展示权重指标，建议在系统中固定 rank_scale，不同请求之间口径不一致。

实用场景

识别高价值落地页：按 backlinks、referring_domains 排序，快速找出外链最强的页面，指导加码和链倾斜。
排查失效页面外链损失：结合 broken_pages、lost_date 找出已失效但仍有外链价值的页面，支持 301 重定向与修复策略。
评估页面级外链质量：通过 backlinks_spam_score、referring_links_attributes、referring_domains_nofollow 判断页面外链结构是否健康，风控与链接洗。
分析外链来源结构：利用 referring_links_tld、referring_links_countries、referring_links_platform_types 评估外链来源地域与平台分布，优化化或行业投放策略。
对比目录或专题页表现：针对单个栏目页或专题页查询页面级汇总，判断哪些页面更容易获得自然引用，为选题规划和数字提供依据。

反向链接域名页面汇总（实时） ​

接口说明 ​

请求地址 ​

计费说明 ​

请求格式 ​

请求参数 ​

filters 参数说明 ​

支持的逻辑连接符 ​

支持的比较操作符 ​

示例 ​

order_by 参数说明 ​

示例 ​

backlinks_filters 参数说明 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

tasks字段 ​

result字段 ​

items字段 ​

响应示例 ​

错误处理 ​

使用建议 ​

实用场景 ​

反向链接域名页面汇总（实时）

接口说明

请求地址

计费说明

请求格式

请求参数

filters 参数说明

支持的逻辑连接符

支持的比较操作符

示例

order_by 参数说明

示例

backlinks_filters 参数说明

请求示例

cURL

Python

TypeScript

响应结构

顶层字段

tasks字段

result字段

items字段

响应示例

错误处理

使用建议

实用场景