反向链接：引荐域名实时查询

POST /v3/backlinks/referring_domains/live

接口说明

该接口用于查询指定目标的**引荐域名（Referring Domains）**明细，即有哪些域名正在向目标站点、子域或页面提供反向链接，并返回这些引荐域名的聚合指标，例如域名权重、反链数量、首次发现时间、丢失时间、nofollow 分布、来源平台类型等。

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

计费说明

该接口按请求计费。

参考价请以游结算为基础换算，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求格式

所有 POST 数据使用 JSON（UTF-8 编码）提交。

请求体需为 JSON 数组 格式：

json

[
 {
 "target": "example.com",
 "limit": 100
 }
]

请求参数

任务参数字段说明

字段名	类型	说明
`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`、`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	可选。是否将目标的子域名纳查询。设为 `false` 时忽略子域名。默认值：`true`。
`include_indirect_links`	boolean	可选。是否间接链接。设为 `true` 时，会纳指向重定向页或 canonical 页面的链接；设为 `false` 时忽略。默认值：`true`。
`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` 个字符。可用于在响应中对业务侧任务。

过滤与排序说明

`filters` 示例

查询反链数量大于 100 的引荐域名：

json

[
 {
 "target": "example.com",
 "filters": [
 ["backlinks", ">", 100]
 ]
 }
]

组合多个条件：

json

[
 {
 "target": "example.com",
 "filters": [
 ["backlinks", ">", 100],
 "and",
 ["rank", ">", 500]
 ]
 }
]

`order_by` 示例

按 rank 降序排序：

json

[
 {
 "target": "example.com",
 "order_by": ["rank,desc"]
 }
]

多字段排序：

json

[
 {
 "target": "example.com",
 "order_by": [
 "rank,desc",
 "backlinks,desc"
 ]
 }
]

`backlinks_filters` 示例

统计 dofollow 反链对应的引荐域名：

json

[
 {
 "target": "example.com",
 "backlinks_filters": [
 ["dofollow", "=", true]
 ]
 }
]

响应结构

接口返回 JSON 数据，顶层 tasks 数组，每个任务对应的获取结果。

顶层响应字段

字段名	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用状态码。错误码列表参考 `/v3/appendix/errors`。建议业务侧做好异常状态处理。
`status_message`	string	通用状态信息。
`time`	string	执行耗时，单位秒。
`cost`	float	本次请求总费用，单位 USD。可按人民币参考换算，以响应中的 `cost` 为准。
`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	数据库中匹的总引荐主域数量。`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`。
`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	指向目标的来源页面数量。
`referring_links_tld`	object	引荐链接来源顶级域分布，例如 `.com`、`.org` 等及对应数量。
`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_domains/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "backlinko.com",
 "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_domains/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "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=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 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: 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.8296 sec.",
 "cost": 0.02015,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "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": 12345,
 "items_count": 5,
 "items": [
 {
 "type": "backlinks_referring_domain",
 "domain": "example.com",
 "rank": 842,
 "backlinks": 156,
 "first_seen": "2019-11-15 12:57:46 +00:00",
 "lost_date": null,
 "backlinks_spam_score": 12,
 "broken_backlinks": 3,
 "broken_pages": 1,
 "referring_domains": 210,
 "referring_domains_nofollow": 34,
 "referring_main_domains": 180,
 "referring_main_domains_nofollow": 28,
 "referring_ips": 95,
 "referring_subnets": 61,
 "referring_pages": 132,
 "referring_links_tld": {
 "com": 120,
 "org": 20
 },
 "referring_links_types": {
 "anchor": 100,
 "image": 12
 },
 "referring_links_attributes": {
 "nofollow": 18,
 "dofollow": 138
 },
 "referring_links_platform_types": {
 "blogs": 45,
 "news": 12
 },
 "referring_links_semantic_locations": {
 "article": 55,
 "section": 10
 },
 "referring_links_countries": {
 "US": 80,
 "GB": 15
 },
 "referring_pages_nofollow": 17
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整个请求的执行状态。
tasks[].status_code 表示单个任务的执行状态。
建议同时检查：
HTTP 状态码
顶层 status_code
tasks_error
各任务的 status_code

常见成功状态：

状态码	含义
`20000`	请求成功

完整错误码与状态说明请参考 /v3/appendix/errors。

使用建议

按业务目标过滤再聚合：如果你只心 dofollow、高质量或特定类型的反链，建议使用 backlinks_filters 缩小样本，再看引荐域名统计。
区分主域与子域口径：total_count 统计的是引荐主域，而 referring_domains 可能将子域单独计数，分析时需注意口径差异。
失效风险：lost_date、broken_backlinks、broken_pages 可用于识别已经失效或即将失效的来源域名。
结合国家与平台分布做来源分析：referring_links_countries 与 referring_links_platform_types 有助于评估外链来源地域和站点类型是否符合目标市场。

实用场景

筛选高价值外链来源域：按 rank、backlinks、dofollow 条件筛选高质量引荐域名，帮助 SEO 团队优维护高价值外链资产。
监控外链来源流失：结合 lost_date、broken_backlinks、broken_pages 识别流失或失效来源，及时发起补链、换链或页面修复。
分析竞争对手外链结构：查询竞品的引荐域分布、平台类型和国家分布，挖掘主要外链增长渠道与区域布局。
评估外链来源健康度：利用 backlinks_spam_score、nofollow 占比、来源平台结构，快速识别垃圾外链风险，优化外链组合质量。
挖掘拓链机会：从新闻站、博客、组织站、Wiki 等来源类型中识别已验证有效的链接渠道，为投放、PR 与外链拓展提供方向。

反向链接：引荐域名实时查询 ​

接口说明 ​

计费说明 ​

请求格式 ​

请求参数 ​

任务参数字段说明 ​

过滤与排序说明 ​

filters 示例 ​

order_by 示例 ​

backlinks_filters 示例 ​

响应结构 ​

顶层响应字段 ​

tasks[] 字段 ​

result[] 字段 ​

items[] 字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​

实用场景 ​

反向链接：引荐域名实时查询

接口说明

计费说明

请求格式

请求参数

任务参数字段说明

过滤与排序说明

`filters` 示例

`order_by` 示例

`backlinks_filters` 示例

响应结构

顶层响应字段

`tasks[]` 字段

`result[]` 字段

`items[]` 字段

请求示例

cURL

Python

TypeScript

响应示例

状态码与错误处理

使用建议

实用场景