反向链接概览（实时）

接口说明

该接口用于获取指定目标的反向链接概览数据，支持以下目标类型：

域名
子域名
网页 URL

接口会返回该目标的反向链接汇总指标，例如反向链接数量、引荐域数量、引荐 IP 数量、垃圾分数、链接类型分布、TLD 分布、平台类型分布等。

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

计费与调用限制

每次请求都会产生费用
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
参考价约 ¥0.3205 / 次
所有 POST 数据均需使用 JSON（UTF-8 编码）
POST 请求体格式为 JSON 数组：[{ ... }]
每分钟最多可发起 2000 次 API 调用
最多支持 30 个并发请求

请求参数

以下为任务设置字段说明。

字段名	类型	说明
`target`	string	填。要查询的目标，可为域名、子域名或网页。域名/子域名不要 `https://` 和 `www.`；网页使用完整绝对 URL，且 `http://` 或 `https://`。
`include_subdomains`	boolean	是否在统计中 `target` 的子域名。可选；默认值：`true`。设为 `false` 时忽略子域名。
`include_indirect_links`	boolean	是否间接链接。可选；默认值：`true`。设为 `true` 时，会纳指向重定向到目标页面或指向 canonical 页面的链接；设为 `false` 时忽略此类链接。
`exclude_internal_backlinks`	boolean	是否排除同一主域下子域名指向 `target` 的反向链接。可选；默认值：`true`。设为 `false` 时会将此类链接计结果。
`internal_list_limit`	integer	部数组的最大返回数。可选；默认值：`10`；最大值：`1000`。会影响以下字段的返回数量：`referring_links_tld`、`referring_links_types`、`referring_links_attributes`、`referring_links_platform_types`、`referring_links_semantic_locations`。
`backlinks_status_type`	string	指定返回并参与聚合统计的反向链接状态。可选；默认值：live``。可选值：all`、`live`（最近一次检查仍存在的链接）、`lost`（已丢失的链接）。
`backlinks_filters`	array	对参与统计的初始反向链接集合进行过滤。可选。可使用 `/v3/backlinks/backlinks/live` 响应中支持的任意字段进行过滤。例如统计 `dofollow` 反向链接。
`rank_scale`	string	指定 `rank`、`domain_from_rank`、`page_from_rank` 的展示刻度。可选；默认值：`one_thousand`。可选值：`one_hundred`（0–100）、`one_thousand`（0–1000）。
`tag`	string	自定义任务标识。可选；最大 255 个字符。可用于请求与响应结果的业务。

`backlinks_filters` 用法说明

backlinks_filters 用于筛选反向链接，再基于筛选后的结果计算聚合指标。例如，只统计 dofollow 反向链接时，可以使用如下结构：

json

"backlinks_filters": [
 ["dofollow", "=", true]
]

这对于建立更精细的反向链接数据视图非常有用，例如：

分析 dofollow 链接
分析某类平台来源的链接
统计特定国家来源的链接
统计某种链接属性或状态的链接

响应结构

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

顶层字段

字段名	类型	说明
`version`	string	API 当前版本。
`status_code`	integer	接口总体状态码。完整错误码说明参考 `/v3/appendix/errors`。建议在系统中做好异常处理。
`status_message`	string	接口总体状态信息。
`time`	string	执行耗时，单位秒。
`cost`	float	本次请求总费用，单位为平台计费币种。
`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	该任务费用。
`result_count`	integer	`result` 数组中的结果数量。
`path`	array	请求路径。
`data`	object	与 POST 请求中提交参数一致。
`result`	array	获取结果数组。

结果字段说明

result[] 中返回目标的反向链接概览数据。

字段名	类型	说明
`target`	string	请求中的目标。
`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`。
`rank`	integer	目标的链接权重指标。
`backlinks`	integer	反向链接总数。
`backlinks_spam_score`	integer	指向该目标的反向链接的总垃圾分数。
`crawled_pages`	integer	针对该目标已抓取的页面数量。
`info`	object	目标的基础信息对象。
`internal_links_count`	integer	目标站点链接总数，为目标页面链数量之和。
`external_links_count`	integer	目标页面外链总数，为目标页面外链数量之和。
`broken_backlinks`	integer	指向该目标的失效反向链接数量。
`broken_pages`	integer	目标站点返回 4xx 或 5xx 的页面数量。该数字可能来自外部链接发现的页面，也可能来自站点 sitemap 发现的页面。
`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	引荐链接属性分布及对应数量。示例值：`nofollow`、`noopener`、`noreferrer`、`external`、`ugc`、`sponsored`。
`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 链接指向该目标的引荐页面数量。

`info` 对象字段

字段名	类型	说明
`server`	string	服务器类型。
`cms`	string	管理系统。
`platform_type`	array	平台类型。
`ip_address`	string	目标 IP 地址。
`country`	string	目标域名所属国家代码。
`is_ip`	boolean	是否为 IP 目标。若为 `true`，表示该目标直接作为 IP 地址使用，而非域名。
`target_spam_score`	integer	目标自身垃圾分数。若目标为域名/子域名，则表示该域名/子域名页面的平均垃圾分数。

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/summary/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "explodingtopics.com",
 "internal_list_limit": 10,
 "include_subdomains": true,
 "backlinks_filters": [
 ["dofollow", "=", true]
 ],
 "backlinks_status_type": "all"
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/backlinks/summary/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "target": "explodingtopics.com",
 "internal_list_limit": 10,
 "include_subdomains": True,
 "backlinks_filters": [
 ["dofollow", "=", True]
 ],
 "backlinks_status_type": "all"
 }
]

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

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 target: "explodingtopics.com",
 internal_list_limit: 10,
 include_subdomains: true,
 backlinks_filters: [
 ["dofollow", "=", true]
 ],
 backlinks_status_type: "all"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/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

{
 "version": "0.1.20230825",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.0162 sec.",
 "cost": 0.02003,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "backlinks",
 "function": "summary",
 "target": "explodingtopics.com",
 "internal_list_limit": 10,
 "include_subdomains": true,
 "backlinks_filters": [
 ["dofollow", "=", true]
 ],
 "backlinks_status_type": "all"
 },
 "result": [
 {
 "ip_address": "172.67.129.80",
 "country": "US",
 "is_ip": false,
 "target_spam_score": 0
 },
 "internal_links_count": 25507,
 "external_links_count": 18419,
 "broken_backlinks": 209,
 "broken_pages": 265,
 "referring_domains": 12372,
 "referring_domains_nofollow": 0,
 "referring_main_domains": 11438,
 "referring_main_domains_nofollow": 0,
 "referring_ips": 10401,
 "referring_subnets": 6427,
 "referring_pages": 38786,
 "referring_links_tld": {
 "com": 26012,
 "pics": 1964,
 "net": 1080,
 "org": 1031,
 "info": 670,
 "hu": 548,
 "co.uk": 527,
 "io": 481,
 "best": 416,
 "co": 299
 },
 "referring_links_types": {
 "anchor": 36666,
 "redirect": 1906,
 "image": 210,
 "canonical": 4
 },
 "referring_links_attributes": {
 "noopener": 8960,
 "noreferrer": 3908,
 "external": 167,
 "sponsored": 34,
 "ugc": 20,
 "alternate": 2
 },
 "referring_links_platform_types": {
 "unknown": 15196,
 "cms": 13222,
 "blogs": 12985,
 "organization": 9525,
 "message-boards": 2679,
 "news": 2295,
 "ecommerce": 36
 },
 "referring_links_semantic_locations": {
 "": 20318,
 "article": 12403,
 "section": 3907,
 "main": 1595,
 "details": 366,
 "figcaption": 116,
 "figure": 38,
 "header": 28,
 "aside": 5,
 "nav": 4
 },
 "referring_links_countries": {
 "": 27445,
 "US": 3867,
 "WW": 1439,
 "IN": 738,
 "GB": 602,
 "IO": 440,
 "CO": 275,
 "DE": 259,
 "IT": 196,
 "BR": 181
 },
 "referring_pages_nofollow": 0
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整次请求的执行状态
tasks[].status_code 表示单个任务的执行状态
建议同时校验：
HTTP 状态码
顶层 status_code
任务级 tasks[].status_code
完整错误码说明请参考 /v3/appendix/errors

常见处理建议：

20000：请求成功
非成功状态码：记录 status_message、请求参数、任务 id，并根据业务场景决定是否重试
当 tasks_error > 0 时，应逐个检查失败任务原因

使用说明与注意事项

查询域名或子域名时，不要带协议头和 www.
查询页面时，传完整 URL
如果你只心有效链接，建议将 backlinks_status_type 设为 live
如果你希望统计站点整体链接生态，可保留 include_subdomains: true
如果你在做外链质量分析，建议结合 backlinks_filters 统计 dofollow、特定国家、特定平台类型的反向链接
若需要更多明细级反向链接数据，可结合 /v3/backlinks/backlinks/live 一起使用

实用场景

评估站点外链资产：快速查看目标域名的反向链接总量、引荐域、引荐页面和引荐 IP，判断站点整体外链规模与权重基础。
筛查垃圾外链风险：结合 backlinks_spam_score、target_spam_score 和失效链接指标，识别高风险站点， SEO 风险审计。
分析外链来源结构：按 TLD、国家、平台类型、语义位置拆解链接来源，判断外链是否集中、是否自然，支持外链建设策略优化。
监控链接流失趋势：通过 backlinks_status_type=lost 观察已丢失链接的汇总，及时发现外链下跌并安排补链或修复。
构建定制化外链指标面板：使用 backlinks_filters 只统计 dofollow 或特定条件链接，为运营、SEO 团队提供更贴近业务目标的监控口径。

反向链接概览（实时） ​

接口说明 ​

计费与调用限制 ​

请求参数 ​

backlinks_filters 用法说明 ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

结果字段说明 ​

info 对象字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用说明与注意事项 ​

实用场景 ​