SeerMarTech API 文档

主题

批量页面摘要（实时） ​

POST /v3/backlinks/bulk_pages_summary/live

本接口使用 POST 方法，路径为：

/v3/backlinks/bulk_pages_summary/live

用于一次获取最多 1000 个页面、域名或子域名的外链摘要及指标。若传单个页面 URL，接口将返回该页面的完整外链概览。

计费与调用限制 ​

  • 每次请求均会计费。
  • 参考价以本平台返回为准，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
  • 请求体使用 UTF-8 编码的 JSON 格式。
  • 每次实时 API 调用只能 1 个任务，因此请求体为单个任务对象的 JSON 数组。 平台限流以认证说明中的 30/60/120 次/分钟规则为准。
  • 同时进行的请求数量最多为 30 个。

请求参数 ​

参数类型填说明
targetsarray是要获取摘要数据的域名、子域名或页面 URL。每次请求最多传 1000 个目标。单次请求中的 URL 最多只能属于 100 个不同域名。域名或子域名不得 https:// 和 www.；页面使用完整绝对 URL，并 http:// 或 https://。
include_subdomainsboolean否是否将目标的子域名纳查询范围。false 表示忽略子域名，默认值为 true。
rank_scalestring否指定 rank、main_domain_rank 等排名指标的计算和展示范围。可选值：one_hundred：0–100；one_thousand：0–1000。默认值为 one_thousand。
tagstring否用户自定义的任务标识，用于请求与结果，最长 255 个字符。提交后可在响应任务的 data 对象中获取。

targets 格式示例 ​

json
[
  "example.com",
  "blog.example.com",
  "https://example.com/article"
]

请求示例 ​

cURL ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/backlinks/bulk_pages_summary/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "targets": [
        "example.com",
        "https://example.com/about"
      ],
      "include_subdomains": true,
      "rank_scale": "one_thousand",
      "tag": "site-summary-001"
    }
  ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/backlinks/bulk_pages_summary/live"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

payload = [
    {
        "targets": [
            "example.com",
            "https://example.com/about"
        ],
        "include_subdomains": True,
        "rank_scale": "one_thousand",
        "tag": "site-summary-001",
    }
]

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

TypeScript ​

typescript
const response = await fetch(
  "https://api.seermartech.cn/v3/backlinks/bulk_pages_summary/live",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      {
        targets: [
          "example.com",
          "https://example.com/about",
        ],
        include_subdomains: true,
        rank_scale: "one_thousand",
        tag: "site-summary-001",
      },
    ]),
  }
);

const result = await response.json();
console.log(result);

响应结构 ​

接口返回 JSON 对象，主要 tasks 任务数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger请求的通用状态码。
status_messagestring请求的通用说明信息。
timestring请求执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

tasks 字段 ​

字段类型说明
idstring任务唯一标识，UUID 格式。
status_codeinteger任务状态码，通常处于 10000–60000 范围。
status_messagestring任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharray当前请求的 URL 路径。
dataobject与提交任务时相同的请求参数。
resultarray当前任务的结果数组。

如需处理状态码及异常，请参错误码说明。

result 字段 ​

字段类型说明
total_countinteger数据库中符合条件的项目总数。
items_countinteger当前结果中 items 的数量。
itemsarray页面外链摘要项目数组。

items 字段 ​

字段类型说明
typestring数据类型，固定为 backlinks_page_summary。
urlstring页面 URL。
rankinteger页面排名指标，表示页面在目标网站中的排名。
main_domain_rankinteger主域名排名指标。
backlinksinteger指向该页面的外链数量。
first_seenstring爬虫首次发现指向该页面的外链的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
lost_datestring最近一次外链丢失的时间。通常表示爬虫访问页面时得到 4xx/5xx 状态码，或发现此前的外链已被移除。UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
backlinks_spam_scoreinteger指向该页面的外链平均垃圾分数。
broken_backlinksinteger失效外链数量。
broken_pagesinteger返回 4xx 或 5xx 状态码、且存在外链指向的页面数量。
referring_domainsinteger引用该页面的域名数量。
referring_domains_nofollowinteger至少一个 nofollow 链接指向目标的域名数量。
referring_main_domainsinteger引用该页面的主域名数量。
referring_main_domains_nofollowinteger至少一个 nofollow 链接指向目标的主域名数量。
referring_ipsinteger引用该页面的 IP 地址数量。
referring_subnetsinteger引用该页面的子网数量。
referring_pagesinteger指向目标 URL 的引用页面数量。
referring_pages_nofollowinteger至少一个 nofollow 链接指向目标的引用页面数量。
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 页面中的语义位置及各位置对应的链接数量，例如：article、section、footer。
referring_links_countriesobject引用链接所在域名的 ISO 国家代码及各国家对应的链接数量。

排名指标说明 ​

rank 和 main_domain_rank 根据链接数据库中的节点排名方法计算，原理类似于 PageRank 算法。数值范围由 rank_scale 参数决定：

  • one_hundred：0–100；
  • one_thousand：0–1000。

日期字段示例 ​

text
2019-11-15 12:57:46 +00:00

响应示例 ​

json
{
  "version": "0.1.20240422",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1566 sec.",
  "cost": 0.02006,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1200 sec.",
      "cost": 0.02006,
      "result_count": 1,
      "path": [
        "v3",
        "backlinks",
        "bulk_pages_summary",
        "live"
      ],
      "data": {
        "api": "backlinks",
        "function": "bulk_pages_summary",
        "targets": [
          "example.com",
          "https://example.com/about"
        ],
        "include_subdomains": true,
        "rank_scale": "one_thousand",
        "tag": "site-summary-001"
      },
      "result": [
        {
          "total_count": 2,
          "items_count": 2,
          "items": [
            {
              "type": "backlinks_page_summary",
              "url": "https://example.com/",
              "rank": 420,
              "main_domain_rank": 560,
              "backlinks": 128,
              "first_seen": "2019-11-15 12:57:46 +00:00",
              "lost_date": null,
              "backlinks_spam_score": 12,
              "broken_backlinks": 3,
              "broken_pages": 1,
              "referring_domains": 46,
              "referring_domains_nofollow": 8,
              "referring_main_domains": 42,
              "referring_main_domains_nofollow": 7,
              "referring_ips": 39,
              "referring_subnets": 35,
              "referring_pages": 91,
              "referring_pages_nofollow": 14,
              "referring_links_tld": {
                "com": 96,
                "org": 20,
                "net": 12
              },
              "referring_links_types": {
                "anchor": 110,
                "image": 15,
                "redirect": 3
              },
              "referring_links_attributes": {
                "nofollow": 14,
                "dofollow": 114
              },
              "referring_links_platform_types": {
                "cms": 72,
                "blogs": 31,
                "news": 25
              },
              "referring_links_semantic_locations": {
                "article": 80,
                "section": 30,
                "footer": 18
              },
              "referring_links_countries": {
                "CN": 40,
                "US": 36,
                "GB": 18
              }
            }
          ]
        }
      ]
    }
  ]
}

实用场景 ​

  • 批量评估重点页面的外链规模，快速识别高外链页面，为更新和链接规划提供依据。
  • 对比多个域名或子域名的引用域名数量，定位外链建设较弱的站点区域，支持 SEO 资源分。
  • 监控页面失效外链与断链页面，优修复影响较大的外链问题，减少链接资产损失。
  • 分析外链的垃圾分数、链接属性和来源国家，筛选高风险外链并优化外链质量。
  • 统计引用链接的类型、平台和 HTML 语义位置，总结有效外链来源模式，指导投放和数字策略。

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

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