主题
反向链接 API 概览
反向链接 API 提供域名、子域名和网页的站链接数据,适用于获取反向链接、引用域名、引用页面及质量指标。数据基于实时索引生成;本平台持续抓取互联网,因此返回的统计数据会随索引更新而变化。
可通过 POST /v3/backlinks/index 查询当前反向链接索引的覆盖规模与更新时间。
反向链接 API 的各接口均使用 Live 实时模式:请求提交后直接返回结果,无需创建任务后再轮询获取。POST 请求体应使用 JSON 数组格式:
json
[
{
"target": "example.com"
}
]可用接口
| 功能 | API 路径 | 说明 |
|---|---|---|
| 索引信息 | /v3/backlinks/index | 查询当前反向链接索引的数据规模与状态。 |
| 概览 | /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/ | 获取指定目标新增和丢失的反向链接、引用域名数量。 |
批量接口
批量接口支持一次查询最多 1000 个域名、子域名或页面的反向链接统计数据。
| 功能 | API 路径 | 说明 |
|---|---|---|
| 批量权重指标 | /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/ | 批量获取新增和丢失引用域名数据。 |
筛选、排序与分页
所有反向链接接口均支持控制返回结果数量,并可对结果进行筛选和排序。
- 可通过请求参数限制返回记录数。
- 可通过筛选条件返回符合业务要求的数据,例如指定链接类型、域名评分、锚文本或页面属性。
- 可通过排序规则调整结果顺序,例如按链接质量、发现时间或指标排序。
- 使用筛选和排序规则不会产生额外费用。
筛选语法与可用字段请参考反向链接 API 的筛选规则文档。
调用方式
反向链接 API 支持实时查询。请求提交后会同步返回处理结果,无需通过独立的 GET 请求查询任务状态。
平台限流以认证说明中的 30/60/120 次/分钟规则为准**
- 最大并发请求数:30
- 如需提升调用频率或并发限制,请联系技术支持。
curl 示例
以下示例查询 example.com 的反向链接概览:
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",
}
# POST 请求体为 JSON 数组
payload = [
{
"target": "example.com",
}
]
response = requests.post(url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())TypeScript 示例
typescript
const response = await fetch(
"https://api.seermartech.cn/v3/backlinks/summary/live/",
{
method: "POST",
headers: {
Authorization: "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json",
},
// POST 请求体为 JSON 数组
body: JSON.stringify([
{
target: "example.com",
},
]),
}
);
if (!response.ok) {
throw new Error(`请求失败:${response.status} ${response.statusText}`);
}
const data = await response.json();
console.log(data);计费说明
反向链接 API 按调用的接口、目标数量及返回数据类型计费。筛选与排序不会额外收费。
每次请求的扣费金额以响应头 X-SeerMarTech-Charge-CNY 为准。建议在生产环境中记录该响应头,以便进行调用成本统计、预算控制和异常请求排查。
实用场景
- 评估网站外链质量:查询目标域名的反向链接、引用域名和质量指标,为 SEO 审计、收购尽调或站点健康检查提供依据。
- 监控新增与丢失链接:通过新增与丢失时间序列接口追踪链接波动,及时发现外链建设成果、自然链接流失或潜在负面 SEO 风险。
- 挖掘竞品外链机会:分析竞争站点或独有的引用域名,识别可用于外联、投稿、媒体合作和资源置换的潜在链接来源。
- 优化锚文本结构:统计目标站点的锚文本分布,识别品牌词、核心和过度优化锚文本的占比,为锚文本策略调整提供数据支持。
- 定位高价值页面:通过域名页面及页面汇总数据找出获得最多外链的页面,复用、链接优化和高潜力主题规划。