主题
反向链接锚文本实时查询
POST /v3/backlinks/anchors/live
接口概述
POST /v3/backlinks/anchors/live
本接口用于查询指定网站、子域名或网页所使用的反向链接锚文本，并返回每个锚文本对应的反向链接、引用域名、链接类型、垃圾链接评分等聚合数据。
请求体使用 UTF-8 编码的 JSON 数组格式。每次实时接口调用只能提交 1 个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准，同时并发请求数最多为 30。
扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
请求参数
| 参数 | 类型 | 填 | 说明 |
|---|---|---|---|
target | string | 是 | 要查询锚文本的目标域名、子域名或网页。域名或子域名不得 https:// 和 www.；网页使用 http:// 或 https:// 的完整 URL。 |
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 连接。 |
order_by | array | 否 | 结果排序规则。可使用与 filters 相同的字段和运算符，排序方向为 asc 或 desc。单次请求最多设置 3 条排序规则，多条规则使用逗号分隔。 |
backlinks_filters | array | 否 | 过滤用于目标聚合指标计算的初始反向链接数据。可使用反向链接接口响应中的字段进行过滤，例如保留 dofollow 链接。 |
include_subdomains | boolean | 否 | 是否将目标的子域名纳查询。false 表示忽略子域名。默认值为 true。 |
include_indirect_links | boolean | 否 | 是否指向间接目标的链接。设置为 true 时，将指向会重定向到目标页面或指向规范页面的页面链接。默认值为 true。 |
exclude_internal_backlinks | boolean | 否 | 是否排除目标自身子域名产生的反向链接。默认值为 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 对象中。 |
过滤条件
支持以下运算符：
regex、not_regex=、<>in、not_inlike、not_likeilike、not_ilikematch、not_match
使用 like 或 not_like 时，可以使用 % 匹任意长度的字符串。
示例：
json
"filters": [
["anchor", "like", "%news%"],
"and",
["backlinks", ">", 10]
]排序示例
json
"order_by": [
"rank,desc",
"backlinks,desc"
]请求示例
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,
"backlinks_status_type": "live",
"filters": [
["anchor", "like", "%news%"]
],
"order_by": [
"rank,desc"
]
}
]'Python
python
import requests
url = "https://api.seermartech.cn/v3/backlinks/anchors/live"
headers = {
"Authorization": "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json",
}
payload = [
{
"target": "forbes.com",
"limit": 4,
"filters": [
["anchor", "like", "%news%"]
],
"order_by": [
"rank,desc"
],
}
]
response = requests.post(url, headers=headers, json=payload, timeout=60)
data = response.json()
if data.get("status_code") == 20000:
print(data)
else:
print(
f"请求失败，错误码：{data.get('status_code')}，"
f"消息：{data.get('status_message')}"
)TypeScript
typescript
import axios from "axios";
const response = await axios.post(
"https://api.seermartech.cn/v3/backlinks/anchors/live",
[
{
target: "forbes.com",
limit: 4,
filters: [
["anchor", "like", "%news%"],
],
order_by: [
"rank,desc",
],
},
],
{
headers: {
Authorization: "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json",
},
}
);
const result = response.data;
if (result.status_code === 20000) {
console.log(result);
} else {
console.error(
`请求失败，错误码：${result.status_code}，消息：${result.status_message}`
);
}响应结构
接口返回 JSON 对象 tasks 任务数组。
顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
version | string | 当前 API 版本。 |
status_code | integer | 请求级状态码。成功通常为 20000。 |
status_message | string | 请求级状态信息。 |
time | string | 请求执行时间，单位为秒。 |
cost | float | 平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。 |
tasks_count | integer | tasks 数组中的任务总数。 |
tasks_error | integer | tasks 数组中执行失败的任务数。 |
tasks | array | 任务结果数组。 |
任务字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 任务唯一标识，UUID 格式。 |
status_code | integer | 任务状态码，通常位于 10000–60000 范围。 |
status_message | string | 任务状态信息。 |
time | string | 任务执行时间，单位为秒。 |
cost | float | 平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。 |
result_count | integer | result 数组中的数量。 |
path | array | 请求 URL 路径。 |
data | object | 请求中提交的任务参数。 |
result | array | 查询结果数组。 |
发生异常或错误时，应根据 status_code 和 status_message 进行错误处理。
结果字段
result 数组中的每个以下字段：
| 字段 | 类型 | 说明 |
|---|---|---|
target | string | 请求中的目标对象。 |
total_count | integer | 数据库中符合条件的项目总数。 |
items_count | integer | 当前返回的项目数量。 |
items | array | 锚文本结果数组。 |
items 字段
| 字段 | 类型 | 说明 |
|---|---|---|
type | string | 结果类型，固定为 backlinks_anchor。 |
anchor | string | 反向链接使用的锚文本。 |
rank | integer | 使用该锚文本的链接向目标传递的链接权重排名。数值范围由 rank_scale 决定。 |
backlinks | integer | 使用该锚文本的反向链接数量。 |
first_seen | string | 爬虫首次发现该锚文本反向链接的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +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 | 引用链接的 HTML 属性及各属性对应的链接数量。 |
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 链接指向目标对象的引用页面数量。 |
响应示例
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": [
{
"id": "ಿದೆa8f1c2-7d25-4a7f-9f42-123456789abc",
"status_code": 20000,
"status_message": "Ok.",
"time": "1.1000 sec.",
"cost": 0.02012,
"result_count": 1,
"path": [
"v3",
"backlinks",
"anchors",
"live"
],
"data": {
"api": "backlinks",
"function": "anchors",
"target": "forbes.com",
"limit": 4,
"order_by": [
"rank,desc"
],
"filters": [
["anchor", "like", "%news%"]
]
},
"result": [
{
"target": "forbes.com",
"total_count": 128,
"items_count": 1,
"items": [
{
"type": "backlinks_anchor",
"anchor": "news",
"rank": 842,
"backlinks": 245,
"first_seen": "2019-11-15 12:57:46 +00:00",
"lost_date": null,
"backlinks_spam_score": 3,
"broken_backlinks": 2,
"broken_pages": 1,
"referring_domains": 96,
"referring_domains_nofollow": 14,
"referring_main_domains": 91,
"referring_main_domains_nofollow": 13,
"referring_ips": 82,
"referring_subnets": 75,
"referring_pages": 198,
"referring_links_tld": {
"com": 210,
"org": 22,
"net": 13
},
"referring_links_types": {
"anchor": 240,
"image": 5
},
"referring_links_attributes": {
"dofollow": 231,
"nofollow": 14
},
"referring_links_platform_types": {
"cms": 180,
"news": 65
},
"referring_links_semantic_locations": {
"article": 190,
"section": 35
},
"referring_links_countries": {
"US": 160,
"GB": 40,
"CA": 20
},
"referring_pages_nofollow": 12
}
]
}
]
}
]
}实用场景
- 分析目标网站的锚文本分布，识别品牌词、核心和泛锚文本比例，评估外链结构是否自然。
- 筛选高权重锚文本反向链接，定位能够传递较高链接权重的外链来源，外链建设和资源优级排序。
- 监控锚文本对应的丢失链接，通过
lost_date和backlinks_status_type发现外链流失，及时开展链接恢复。 - 识别高风险锚文本组合，结合
backlinks_spam_score、引用域名和链接属性，排查可能影响网站质量评估的垃圾外链。 - 对比不同国家、平台和页面位置的外链来源，利用
referring_links_countries、referring_links_platform_types和referring_links_semantic_locations优化化 SEO 与投放策略。