反向链接锚文本实时查询

接口说明

该接口用于查询指定网站、子域名或网页的反向链接锚文本（Anchor）分布，并返回每个锚文本对应的详细外链指标，例如外链数量、引荐域数量、首次发现时间、丢失时间、垃圾分数、链接类型分布等。

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

计费说明

该接口按请求计费。

参考价需结合平台定价换算，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求体

所有 POST 数据均需使用 JSON 编码，且请求体格式为 JSON 数组：

json

[
 {
 "target": "forbes.com",
 "limit": 4
 }
]

请求参数

字段名	类型	说明
`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` 支持 `%` 通任意长度字符串。
`order_by`	array	可选。结果排序规则。可使用与 `filters` 相同的字段。排序方式：`asc`（升序）、`desc`（降序）。单次请求最多支持 3 条排序规则。
`backlinks_filters`	array	可选。用于过滤参与聚合计算的原始外链数据集。可按 `/v3/backlinks/backlinks/live/` 响应中的任意字段进行筛选。例如只统计 dofollow 外链。
`include_subdomains`	boolean	可选。是否在查询中 `target` 的子域名。设为 `false` 时忽略子域名。默认值：`true`。
`include_indirect_links`	boolean	可选。是否间接链接。设为 `true` 时，结果会指向重定向页面或 canonical 页面的链接数据；设为 `false` 时忽略此类链接。默认值：`true`。
`exclude_internal_backlinks`	boolean	可选。是否排除来自目标站点子域名的外链。原文说明中：设为 `false` 时，会忽略来自 `target` 子域名的外链，因此不会在结果中收到相同主域的数据。默认值：`true`。
`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 支持对结果进行灵活筛选，可组合多个条件。基本结构示例：

json

[
 ["anchor", "like", "%news%"],
 "and",
 ["backlinks", ">", 10]
]

可用逻辑连接词：

and
or

可用操作符：

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

说明：

like / not_like 支持 % 作为通符
过滤字段需使用该接口结果中支持的字段
最多可设置 8 个过滤条件

order_by 用法说明

order_by 用于设置结果排序，格式示例：

json

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

说明：

asc：升序
desc：降序
最多支持 3 条排序规则

backlinks_filters 用法说明

backlinks_filters 用于过滤原始外链集合，再基于筛选后的数据进行锚文本聚合统计。

例如统计 dofollow 外链：

json

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

这适用于需要构建特定范围的外链样本，例如：

看 dofollow 外链
看某类平台来源外链
看特定国家、语言或状态的外链

响应结构

接口返回 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`	array	锚文本结果列表。

items 数组字段

字段名	类型	说明
`type`	string	素类型，固定为 `backlinks_anchor`。
`anchor`	string	反向链接的锚文本。
`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 格式。
`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`、`summary`。
`referring_links_countries`	object	引荐链接所在域名的 ISO 国家代码分布及数量。
`referring_pages_nofollow`	integer	使用该锚文本、且至少一条 nofollow 链接的引荐页面数量。

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/backlinks/anchors/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "forbes.com",
 "limit": 4,
 "filters": [
 ["anchor", "like", "%news%"]
 ],
 "order_by": ["backlinks,desc"]
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/backlinks/anchors/live"
payload = [
 {
 "target": "forbes.com",
 "limit": 4,
 "filters": [
 ["anchor", "like", "%news%"]
 ],
 "order_by": ["backlinks,desc"]
 }
]
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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

TypeScript

typescript

import axios from "axios";

const postArray = [
 {
 target: "forbes.com",
 limit: 4,
 filters: [
 ["anchor", "like", "%news%"]
 ],
 order_by: ["backlinks,desc"]
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/anchors/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postArray
})
 .then((response) => {
 // 输出返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

json

{
 "version": "0.1.20230825",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.1820 sec.",
 "cost": 0.02012,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "backlinks",
 "function": "anchors",
 "target": "forbes.com",
 "limit": 4,
 "order_by": ["backlinks,desc"],
 "filters": [
 ["anchor", "like", "%news%"]
 ]
 },
 "result": [
 {
 "target": "forbes.com",
 "total_count": 0,
 "items_count": 0,
 "items": []
 }
 ]
 }
 ]
}

错误处理

建议同时处理两层状态：

HTTP 状态码
响应体中的 status_code / tasks[].status_code

常见检查方式：

顶层 status_code = 20000 表示请求成功
若 tasks_error > 0，说明部分任务执行失败
错误原因应结合 status_message 与任务级 status_message 判断

错误码列表可参考：/v3/appendix/errors

使用建议

查询域名或子域名时，不要携带 https:// 和 www.
查询单个页面时，传完整 URL
若要分析品牌词/非品牌词锚文本结构，建议合 filters 使用
若要只统计某类外链，建议使用 backlinks_filters
如果需要稳定分页，请结合 offset + limit + order_by 使用

实用场景

分析品牌锚文本占比：识别品牌词、通用词、精准锚文本的分布，评估外链画像是否自然，规避过度优化风险。
定位高价值锚文本来源：按 rank、backlinks、referring_domains 排序，找出传递权重最高的锚文本，用于反推优质外链策略。
监控锚文本异常波动：定期拉取 lost_date、broken_backlinks 等指标，发现锚文本外链丢失或失效，及时修复重要链接资产。
筛选特定外链样本做聚合分析：通过 backlinks_filters 统计 dofollow、特定平台类型或特定国家来源的外链，获得更贴近业务目标的锚文本结构数据。
评估化外链分布：结合 referring_links_countries 与 referring_links_tld，查看不同国家和域后缀的锚文本分布，为海外 SEO 和多市场投放提供依据。

反向链接锚文本实时查询 ​

接口说明 ​

计费说明 ​

请求体 ​

请求参数 ​

filters 用法说明 ​

order_by 用法说明 ​

backlinks_filters 用法说明 ​

响应结构 ​

顶层字段 ​

tasks 数组字段 ​

result 数组字段 ​

items 数组字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

错误处理 ​

使用建议 ​

实用场景 ​

反向链接锚文本实时查询

接口说明

计费说明

请求体

请求参数

filters 用法说明

order_by 用法说明

backlinks_filters 用法说明

响应结构

顶层字段

tasks 数组字段

result 数组字段

items 数组字段

请求示例

cURL

Python

TypeScript

响应示例

错误处理

使用建议

实用场景