SeerMarTech API 文档

主题

反向链接域交集实时查询 ​

POST /v3/backlinks/domain_intersection/live

接口说明 ​

该接口用于查询同时指向指定网站集合的来源域名列表。它特别适合构建“外链差距（Link Gap）”分析能力：找出哪些域名给竞争对手做了外链，但没有链接到你的网站。

  • 请求方式：POST
  • 接口路径：/v3/backlinks/domain_intersection/live
  • 完整地址：https://api.seermartech.cn/v3/backlinks/domain_intersection/live

计费与调用限制 ​

该接口按请求计费。

  • 参考价：扣费以响应头 X-SeerMarTech-Charge-CNY 为准
  • 响应中的 cost 为平台计费值
  • 调用频率上限：每分钟最多 2000 次 API 调用
  • 并发请求上限：最多 30 个同时请求

所有 POST 数据使用 JSON UTF-8 编码，且请求体格式为 JSON 数组：[{ ... }]

请求参数 ​

任务对象字段 ​

字段名类型说明
targetsobject填。要查询交集外链的目标集合，可传域名、子域名或页面，最多 20 个。域名或子域名不要带 https:// 和 www.；页面使用完整绝对 URL（ http:// 或 https://）。
exclude_targetsarray可选。要排除的域名、子域名或页面，最多 10 个。如果设置该字段，返回结果：链接到 targets，但不链接到 exclude_targets 的来源域名。
filtersarray可选。结果过滤条件数组，最多 8 个过滤条件。多个条件之间需使用逻辑运算符 and / or 连接。
order_byarray可选。结果排序规则。可使用与 filters 相同的字段路径。排序方向支持 asc 和 desc，单次请求最多 3 条排序规则。
offsetinteger可选。结果偏移量，默认 0。例如设为 10 时，将跳过前 10 条结果。
limitinteger可选。返回结果数量上限，默认 100，最大 1000。
internal_list_limitinteger可选。限制数组字段返回数量。默认 10，最大 1000。适用于：referring_links_tld、referring_links_types、referring_links_attributes、referring_links_platform_types、referring_links_semantic_locations。
backlinks_status_typestring可选。指定统计和返回哪类反向链接。可选值：all、live、lost``；默认 live`。
backlinks_filtersarray可选。对用于聚合统计的原始反向链接数据集进行过滤。可使用 /v3/backlinks/backlinks/live 响应中的任意字段作为过滤条件。例如保留 dofollow 外链。
include_subdomainsboolean可选。是否将目标的子域名纳搜索范围。默认 true；设为 false 时忽略子域名。
include_indirect_linksboolean可选。是否间接链接。默认 true。若为 true，会指向跳转页或 canonical 页、并最终指向目标的链接。
exclude_internal_backlinksboolean可选。是否排除来自目标自身子域名的外链。默认 true。如设为 false，则不会排除这类链接，返回中可能出现相同主域体系的来源。
intersection_modestring可选。交集计算模式。可选值：all、partial，默认 all。all 基于外链结果；partial 基于交叉部分外链结果。
rank_scalestring可选。定义 rank、domain_from_rank、page_from_rank 的数值范围。可选值：one_hundred（0–100）、one_thousand（0–1000），默认 one_thousand。
tagstring可选。自定义任务标识，最大 255 个字符，可用于请求与响应匹。

过滤与排序 ​

filters 支持的操作符 ​

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

说明：

  • like 和 not_like 支持 % 通符，用于匹任意长度字符串
  • 可组合多个过滤条件，但总数最多 8 个
  • 完整可过滤字段请参考 /v3/backlinks/filters/

order_by 说明 ​

  • 排序方向：
  • asc：升序
  • desc：降序
  • 单次请求最多 3 条排序规则
  • 每条规则写法示例："1.backlinks,desc"

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/backlinks/domain_intersection/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "targets": {
 "1": "moz.com",
 "2": "ahrefs.com"
 },
 "exclude_targets": [
 "semrush.com"
 ],
 "limit": 5,
 "order_by": [
 "1.backlinks,desc"
 ],
 "include_subdomains": false,
 "exclude_internal_backlinks": true
 }
]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/backlinks/domain_intersection/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "targets": {
 "1": "moz.com",
 "2": "ahrefs.com"
 },
 "exclude_targets": [
 "semrush.com"
 ],
 "limit": 5,
 "include_subdomains": False,
 "exclude_internal_backlinks": True,
 "order_by": [
 "1.backlinks,desc"
 ]
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postData = [
 {
 targets: {
 "1": "moz.com",
 "2": "ahrefs.com"
 },
 exclude_targets: ["semrush.com"],
 limit: 5,
 order_by: ["1.backlinks,desc"],
 include_subdomains: false,
 exclude_internal_backlinks: true
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/backlinks/domain_intersection/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.response?.data || error.message);
 });

响应结构 ​

接口返回 JSON，顶层 tasks 数组。

顶层字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码
status_messagestring通用状态信息
timestring执行耗时，单位秒
costfloat本次请求总成本（USD）
tasks_countintegertasks 数组中的任务数
tasks_errorinteger执行出错的任务数
tasksarray任务结果数组

建议对 status_code 和任务级状态码建立统一异常处理机制。错误码可参考 /v3/appendix/errors

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000–60000
status_messagestring任务状态说明
timestring任务执行耗时
costfloat任务成本（USD）
result_countintegerresult 数组中的数量
patharray请求路径
dataobject回显请求时提交的参数
resultarray结果数组

result[] 字段 ​

字段名类型说明
targetsobject请求中的目标集合
total_countinteger与请求匹的结果总数
items_countinteger当前 items 数组返回的结果数量
itemsarray链接到 targets 中目标的来源域名列表
summaryobject域交集汇总信息

items[] 字段 ​

每个 items素代表一个来源域名及对各目标的交集数据。

字段名类型说明
domain_intersectionobject针对请求中每个目标的交集数据，按 targets 中的编号返回，例如 1、2、3 等

domain_intersection.{n} 字段 ​

{n} 对应 targets 中的键名，范围通常为 1 到 20。

字段名类型说明
typestring素类型，固定为 backlinks_domain_intersection
targetstring指向对应目标的来源域名
rankinteger该来源域名相对于目标的权重值。该指标基于链接数据库中的节点排序方法计算，原理与早期 PageRank 类似。
backlinksinteger反向链接数量
first_seenstring首次发现该来源域名链接到目标的时间，UTC 格式：yyyy-mm-dd hh:mm:ss +00:00
lost_datestring最近一次该来源域名的最后一个外链丢失的时间，UTC 格式：yyyy-mm-dd hh:mm:ss +00:00
backlinks_spam_scoreinteger指向该目标的外链平均垃圾分数
broken_backlinksinteger失效反向链接数量
broken_pagesinteger失效页面数量
referring_domainsinteger来源域名数量
referring_domains_nofollowinteger至少一个 nofollow 链接的来源域名数量
referring_main_domainsinteger来源主域数量
referring_main_domains_nofollowinteger至少一个 nofollow 链接的来源主域数量
referring_ipsinteger来源 IP 数量
referring_subnetsinteger来源子网数量
referring_pagesinteger指向目标的来源页面数量
referring_links_tldobject来源链接的顶级域分布及数量
referring_links_typesobject来源链接类型分布及数量。可选值：anchor、image、link、meta、canonical、alternate、redirect
referring_links_attributesobject来源链接属性分布及数量
referring_links_platform_typesobject来源平台类型分布及数量。可选值：cms、blogs、ecommerce、message-boards、wikis、news、organization
referring_links_semantic_locationsobject来源链接所在 HTML 语义位置分布及数量
referring_links_countriesobject来源链接所在域名的 ISO 国家/地区代码分布及数量
referring_pages_nofollowinteger至少一个 nofollow 链接的来源页面数量

summary 字段 ​

字段名类型说明
intersections_countinteger交集总数

响应示例 ​

json
{
 "version": "0.1.20230825",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "6.1727 sec.",
 "cost": 0.02015,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "0db4f0b8-6a0d-4f0a-9d7f-1b6d2c3e4f5a",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "6.1012 sec.",
 "cost": 0.02015,
 "result_count": 1,
 "path": [
 "v3",
 "backlinks",
 "domain_intersection",
 "live"
 ],
 "data": {
 "api": "backlinks",
 "function": "domain_intersection",
 "targets": {
 "1": "moz.com",
 "2": "ahrefs.com"
 },
 "include_subdomains": false,
 "exclude_targets": [
 "semrush.com"
 ],
 "limit": 5,
 "order_by": [
 "1.backlinks,desc"
 ],
 "exclude_internal_backlinks": true
 },
 "result": [
 {
 "targets": {
 "1": "moz.com",
 "2": "ahrefs.com"
 },
 "total_count": 1243,
 "items_count": 5,
 "items": [
 {
 "domain_intersection": {
 "1": {
 "type": "backlinks_domain_intersection",
 "target": "example-referrer.com",
 "rank": 742,
 "backlinks": 118,
 "first_seen": "2023-04-11 09:20:15 +00:00",
 "lost_date": null,
 "backlinks_spam_score": 5,
 "broken_backlinks": 2,
 "broken_pages": 1,
 "referring_domains": 1,
 "referring_domains_nofollow": 0,
 "referring_main_domains": 1,
 "referring_main_domains_nofollow": 0,
 "referring_ips": 1,
 "referring_subnets": 1,
 "referring_pages": 64,
 "referring_links_tld": {
 "com": 118
 },
 "referring_links_types": {
 "anchor": 110,
 "image": 8
 },
 "referring_links_attributes": {
 "dofollow": 112,
 "nofollow": 6
 },
 "referring_links_platform_types": {
 "blogs": 40,
 "news": 24
 },
 "referring_links_semantic_locations": {
 "article": 70,
 "nav": 12
 },
 "referring_links_countries": {
 "US": 86,
 "GB": 12
 },
 "referring_pages_nofollow": 4
 },
 "2": {
 "type": "backlinks_domain_intersection",
 "target": "example-referrer.com",
 "rank": 695,
 "backlinks": 87,
 "first_seen": "2023-05-02 14:11:03 +00:00",
 "lost_date": null,
 "backlinks_spam_score": 4,
 "broken_backlinks": 1,
 "broken_pages": 0,
 "referring_domains": 1,
 "referring_domains_nofollow": 0,
 "referring_main_domains": 1,
 "referring_main_domains_nofollow": 0,
 "referring_ips": 1,
 "referring_subnets": 1,
 "referring_pages": 49,
 "referring_links_tld": {
 "com": 87
 },
 "referring_links_types": {
 "anchor": 80,
 "image": 7
 },
 "referring_links_attributes": {
 "dofollow": 82,
 "nofollow": 5
 },
 "referring_links_platform_types": {
 "blogs": 31,
 "news": 18
 },
 "referring_links_semantic_locations": {
 "article": 55,
 "footer": 10
 },
 "referring_links_countries": {
 "US": 60,
 "CA": 9
 },
 "referring_pages_nofollow": 3
 }
 }
 }
 ],
 "summary": {
 "intersections_count": 1243
 }
 }
 ]
 }
 ]
}

状态码与错误处理 ​

  • 顶层 status_code 表示整个请求处理结果
  • tasks[].status_code 表示单个任务处理结果
  • 建议同时检查：
  • HTTP 状态码
  • 顶层 status_code
  • 任务级 tasks[].status_code

常见处理建议：

  1. HTTP 非 200：按网络或网异常处理
  2. status_code 非 20000：按接口调用失败处理
  3. tasks_error 大于 0：说明部分或任务失败
  4. result_count 为 0：请求成功，但没有匹数据

完整错误码说明请参考 /v3/appendix/errors

使用建议 ​

  • 做竞争分析时，通常将自己网站放 exclude_targets，竞争对手放 targets
  • 如果只分析主域层级，建议设置 include_subdomains=false
  • 如需过滤低质量链接，可结合 backlinks_filters 与 backlinks_spam_score
  • 若只需要交叉链接而非量合并结果，可尝试 intersection_mode=partial

实用场景 ​

  • 识别竞争对手外链差距：找出同时链接多个竞品、但未链接自家站点的来源域名，快速生成外链拓展名单。
  • 筛选高价值外链资源：按 rank、backlinks、平台类型等维度排序，优联系权重高且性强的来源站点。
  • 排除品牌自有网络干扰：通过 exclude_internal_backlinks 和 exclude_targets 去除自有子域及已覆盖站点，提升差距分析准确性。
  • 评估外链质量结构：查看交集来源域名的国家分布、链接类型、nofollow 占比和垃圾分数，判断外链建设方向。
  • 构建自动化 Link Gap 报表：周期性对比自家与竞品外链交集，监控新增可争取来源域名，支持销售线索或 SEO 外联团队执行。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API