批量查询实时反向链接数量

POST /v3/backlinks/bulk_backlinks/live

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

/v3/backlinks/bulk_backlinks/live

用于批量查询指定域名、子域名或网页的反向链接数量。返回结果统计最近一次检查时发现的实时反向链接 nofollow、noreferrer、ugc、sponsored 等属性的链接。

当目标值为域名时，结果统计该根域名及所有子域名。例如，提交 example.com 后，结果会覆盖 example.com 和 app.example.com 等子域名。

请求地址

http

POST https://api.seermartech.cn/v3/backlinks/bulk_backlinks/live

计费说明

每次请求按调用计费。参考价约 ¥0.145 / 次。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制：

平台限流以认证说明中的 30/60/120 次/分钟规则为准。

每次 Live API 调用只能 1 个任务对象。
同时进行的请求最多为 30 个。
请求体使用 UTF-8 编码的 JSON 格式。
POST 请求体是 JSON 数组。

请求参数

请求体是任务数组，每个数组代表一个任务。

参数	类型	填	说明
`targets`	array	是	要查询反向链接数量的域名、子域名或网页列表，最多支持 1000 个目标。
`tag`	string	否	用户自定义的任务标识，最多 255 个字符。该值会原样返回在响应任务的 `data` 对象中，可用于请求和结果。

`targets` 参数格式

域名或子域名不应 https:// 和 www.。
网页使用完整绝对 URL，并 http:// 或 https://。
域名、子域名和网页可以混合提交。

示例：

json

[
  {
    "targets": [
      "example.com",
      "blog.example.com",
      "https://www.example.com/products/"
    ],
    "tag": "backlinks_batch_001"
  }
]

请求示例

cURL

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/backlinks/bulk_backlinks/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "targets": [
        "forbes.com",
        "cnn.com",
        "bbc.com",
        "yelp.com",
        "https://www.apple.com/iphone/",
        "https://ahrefs.com/blog/",
        "ibm.com",
        "https://variety.com/",
        "https://stackoverflow.com/",
        "www.trustpilot.com"
      ],
      "tag": "bulk_backlinks_demo"
    }
  ]'

Python

python

import requests

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

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

post_data = [
    {
        "targets": [
            "forbes.com",
            "cnn.com",
            "bbc.com",
            "yelp.com",
            "https://www.apple.com/iphone/",
            "https://ahrefs.com/blog/",
            "ibm.com",
            "https://variety.com/",
            "https://stackoverflow.com/",
            "www.trustpilot.com",
        ],
        "tag": "bulk_backlinks_demo",
    }
]

response = requests.post(url, headers=headers, json=post_data)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，错误码：%s，错误信息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

const postData = [
  {
    targets: [
      "forbes.com",
      "cnn.com",
      "bbc.com",
      "yelp.com",
      "https://www.apple.com/iphone/",
      "https://ahrefs.com/blog/",
      "ibm.com",
      "https://variety.com/",
      "https://stackoverflow.com/",
      "www.trustpilot.com",
    ],
    tag: "bulk_backlinks_demo",
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/backlinks/bulk_backlinks/live",
    postData,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    // 处理响应数据
    console.log(response.data);
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.message);
  });

响应结构

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

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	请求级状态码。完整状态码列表请参考错误码文档。
`status_message`	string	请求级状态信息。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务总数。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务结果数组。

`tasks` 字段

字段	类型	说明
`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	请求路径信息。
`data`	object	创建任务时提交的参数。
`result`	array	任务结果数组。

`result` 与 `items` 字段

字段	类型	说明
`items_count`	integer	`items` 数组中的结果数量。
`items`	array	反向链接统计结果。
`target`	string	请求中提交的域名、子域名或网页。
`backlinks`	integer	指向 `target` 的反向链接数量。

响应示例

json

{
  "version": "0.1.20210917",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "2.0128 sec.",
  "cost": 0.0203,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "1.9541 sec.",
      "cost": 0.0203,
      "result_count": 1,
      "path": [
        "v3",
        "backlinks",
        "bulk_backlinks",
        "live"
      ],
      "data": {
        "api": "backlinks",
        "function": "bulk_backlinks",
        "targets": [
          "example.com",
          "https://www.example.com/products/"
        ],
        "tag": "bulk_backlinks_demo"
      },
      "result": [
        {
          "items_count": 2,
          "items": [
            {
              "target": "example.com",
              "backlinks": 125430
            },
            {
              "target": "https://www.example.com/products/",
              "backlinks": 348
            }
          ]
        }
      ]
    }
  ]
}

状态码与异常处理

status_code: 20000 表示请求成功。
应用程序应同时检查顶层 status_code、任务级 status_code 及对应的 status_message。
当 tasks_error 大于 0 时，说明至少有一个任务处理失败，应根据任务级状态码进行重试、记录或人工排查。
建议在客户端实现时、限流、网络异常和业务错误的处理机制。

实用场景

批量对比竞争对手的反向链接规模，快速识别外链资源更丰富的竞争域名，为竞争分析和外链策略制定提供依据。
监测重点页面的外链数量，评估产品页、落地页或页的链接资产积累，判断页面权重变化。
筛选高潜力外链合作对象，批量统计候选网站的反向链接规模，优联系备较强链接资源的站点。
构建域名级 SEO 资产报表，定期记录多个项目站点及子域名的外链数量，用于 SEO 周报、月报和增长趋势分析。
评估发布效果，对比上线前后的反向链接数量变化，判断营销和数字活动带来的链接价值。

批量查询实时反向链接数量 ​

请求地址 ​

计费说明 ​

请求参数 ​

targets 参数格式 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

tasks 字段 ​

result 与 items 字段 ​

响应示例 ​

状态码与异常处理 ​

实用场景 ​