Backlinks API 概览

Backlinks API 用于获取域名、子域名和网页层级的外链数据，是构建外链分析、竞品链接研究与链接质量评估能力的核心接口集合。

本接口可提供任意目标的站链接、引荐域名、引荐页面等数据，数据基于实时索引返回。平台 API 持续抓取互联网，因此接口返回的统计结果通常可反映最新可用数据。

本平台会持续扩展抓取基础设施、扩大索引规模，并不断补新的统计维度。你可以通过 /v3/backlinks/index 端点查看当前外链数据库的最新索引规模。

可用端点

Backlinks API 当前提供以下面向不同分析场景的端点：

/v3/backlinks/summary/live/：返回目标的完整外链概况
/v3/backlinks/history/live/：查看目标历史外链表现与链接建设趋势
/v3/backlinks/backlinks/live/：返回目标的详细外链列表
/v3/backlinks/anchors/live/：返回目标的锚文本及统计
/v3/backlinks/domain_pages/live/：查看目标站点中外链最多或最少的页面
/v3/backlinks/domain_pages_summary/live/：汇总目标域名或子域名下各页面的外链及指标
/v3/backlinks/referring_domains/live/：按引荐域名拆分查看指向目标的外链数据
/v3/backlinks/referring_networks/live/：查看向目标发送外链的 IP 地址与子网
/v3/backlinks/competitors/live/：列出与目标部分外链画像的竞争对手
/v3/backlinks/domain_intersection/live/：列出同时指向指定多个目标的域名
/v3/backlinks/page_intersection/live/：列出同时指向指定多个目标的引荐页面
/v3/backlinks/timeseries_summary/live/：返回目标域名在两个指定日期之间的外链时序数据
/v3/backlinks/timeseries_new_lost_summary/live/：返回目标新增与丢失外链、引荐域名数量的时间序列汇总

批量端点

除上述单目标查询接口外，Backlinks API 还支持批量获取最多 1000 个域名、子域名或页面的外链统计数据。可用批量端点：

/v3/backlinks/bulk_ranks/live/
/v3/backlinks/bulk_backlinks/live/
/v3/backlinks/bulk_spam_score/live/
/v3/backlinks/bulk_referring_domains/live
/v3/backlinks/bulk_new_lost_backlinks/live/
/v3/backlinks/bulk_new_lost_referring_domains/live/

过滤与排序

大多数外链端点支持：

指定返回结果数量
对结果集进行过滤
对结果集进行排序

使用过滤与排序规则不会产生额外费用。通过自定义过滤条件，你可以更精确地获取所需数据。过滤语法与可用规则请参考 Backlinks API 的过滤规则文档。

调用方式

Backlinks API 支持 Live 实时调用方式。

这意味着：

无需拆分为单独的 POST 与 GET 轮询流程
请求提交后即可直接返回结果
适合实时查询、交互式分析与在线系统集成

频率限制

每分钟最多可发送 2000 次 API 调用
同时并发请求数上限为 30

如需提升调用额，请联系平台支持。

认证方式

所有请求均需在请求头中携带 API Token：

bash

Authorization: Bearer smt_live_YOUR_KEY

请求示例

以下示例演示如何调用一个 Backlinks API 的 Live 端点。不同端点的请求参数会有所不同，但 POST 请求体统一为 JSON 数组格式：[{ ... }]。

cURL

bash

curl -X POST "https://api.seermartech.cn/v3/backlinks/summary/live/" \
 -H "Authorization: Bearer smt_live_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '[
 {
 "target": "example.com"
 }
 ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/backlinks/summary/live/"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "target": "example.com"
 }
]

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

TypeScript

typescript

const url = "https://api.seermartech.cn/v3/backlinks/summary/live/";

const response = await fetch(url, {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify([
 {
 target: "example.com"
 }
 ])
});

const data = await response.json;
console.log(response.status);
console.log(data);

通用请求参数说明

不同端点支持的参数并不相同，但 Backlinks API 常见参数：

参数	类型	说明
`target`	string	目标域名、子域名或页面 URL
`limit`	integer	返回结果数量上限
`offset`	integer	分页偏移量
`filters`	array	过滤条件，用于限定返回数据范围
`order_by`	array	排序规则
`include_subdomains`	boolean	是否子域名数据，以端点支持为准
`backlinks_status_type`	string	外链状态类型，适用于部分端点
`date_from`	string	起始日期，通常用于历史或时序类端点
`date_to`	string	结束日期，通常用于历史或时序类端点

通用响应结构

Backlinks API 的响应通常以下结构字段：

字段	类型	说明
`version`	string	API 版本
`status_code`	integer	响应状态码
`status_message`	string	响应状态描述
`time`	string	请求处理耗时
`cost`	number	本次请求扣费金额
`tasks_count`	integer	本次提交的任务数量
`tasks_error`	integer	失败任务数量
`tasks`	array	任务结果列表

tasks 数组中的每个任务通常还会：

字段	类型	说明
`id`	string	任务 ID
`status_code`	integer	任务状态码
`status_message`	string	任务状态描述
`time`	string	单任务处理耗时
`cost`	number	单任务扣费
`result_count`	integer	返回结果集数量
`path`	array	当前请求路径
`data`	object	请求参数回显
`result`	array	业务结果数据

响应示例

以下为通用示例，字段会因端点不同而变化：

json

{
 "version": "0.1.20240101",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1234 sec.",
 "cost": 0.0200,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "01234567-89ab-cdef-0123-456789abcdef",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1011 sec.",
 "cost": 0.0200,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "summary",
 "live"
 ],
 "data": {
 "target": "example.com"
 },
 "result": [
 {
 "target": "example.com"
 }
 ]
 }
 ]
}

错误处理

调用 Backlinks API 时，建议优检查以下字段：

顶层 status_code 与 status_message
tasks 中每个任务的 status_code 与 status_message
tasks_error 是否大于 0

常见处理建议：

场景	建议
认证失败	检查 Bearer Token 是否正确、是否备接口权限
参数错误	检查 `target`、日期格式、过滤表达式及分页参数
频率限	降低调用频率，控制每分钟请求量与并发数
余额不足或扣费异常	以响应中的 `cost` 字段为准，并检查账户余额
单任务失败	遍历 `tasks` 数组，逐个任务处理错误信息

计费说明

Backlinks API 的访问费用会从账户余额中扣除，余额可用于本平台的 API 服务。

本文为概览页，未给出各端点固定单价，因此无法在此页换算人民币参考价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

你也可以通过用户数据接口查询账户余额与消费。

测试与验证

如需在正式接前验证请求参数、响应结构和业务逻辑，建议在测试环境中完成联调，再逐步切换到生产调用。

使用建议

为获得更高的调用效率，建议按以下方式组织请求：

概览分析优使用 /v3/backlinks/summary/live/
明细分析使用 /v3/backlinks/backlinks/live/
趋势分析使用 /v3/backlinks/history/live/ 或时序类端点
多目标批量比对时优使用 bulk 系列端点
通过 filters 与 order_by 减少无结果返回量，降低后处理成本

实用场景

分析竞品外链结构，识别高价值引荐域名与核心投放渠道，制定更有效的链接建设策略
监控目标站点新增与流失外链，及时发现外链波动、合作下线或负面 SEO 风险
挖掘高权重落地页，找出获得最多外链的页面，为选题和链分发提供依据
对比多个竞争域名的引荐来源，发现尚未覆盖的外链资源，提升外链拓展效率
评估站点链接质量，通过锚文本、引荐网络与垃圾分数等维度识别异常链接与潜在风险

Backlinks API 概览 ​

可用端点 ​

批量端点 ​

过滤与排序 ​

调用方式 ​

频率限制 ​

认证方式 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

通用请求参数说明 ​

通用响应结构 ​

响应示例 ​

错误处理 ​

计费说明 ​

测试与验证 ​

使用建议 ​

实用场景 ​