WHOIS 域名概览（实时）

POST /v3/domain_analytics/whois/overview/live

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

/v3/domain_analytics/whois/overview/live

接口返回符合筛选条件的域名 WHOIS 信息，并补外链统计、自然搜索排名与流量、付费搜索排名与流量等数据。每个 Live 请求最多一个任务；平台限流以认证说明中的 30/60/120 次/分钟规则为准。

所有 POST 请求体使用 UTF-8 编码的 JSON 数组格式：

json

[
  {
    "limit": 10
  }
]

计费说明

每次请求按任务计费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

响应中的 cost 字段（平台原始 USD 成本兼容字段）表示任务成本数值，人民币扣费请以响应头为准。

请求参数

以下参数应放在请求体数组中的任务对象。

参数	类型	说明
`limit`	integer	返回的最大域名数量。可选，默认值为 `100`，最大值为 `1000`。
`offset`	integer	结果数组的偏移量。可选，默认值为 `0`。例如设置为 `10` 时，跳过前 10 条结果并返回后续数据。获取不 10,000 条结果时可使用此参数；获取更多结果时建议使用 `offset_token`。
`offset_token`	string	用于获取后续结果的令牌。该值由上一次响应中的同名字段提供。适合在单次任务需要获取 100,000 条结果时请求时。每个后续任务的 `offset_token` 都是唯一的。使用该参数时，请求参数与上一次请求保持一致。
`filters`	array	结果过滤条件。可选，最多设置 8 个过滤条件。多个条件之间使用逻辑运算符 `and` 或 `or` 连接。支持的运算符：`regex`、`<`、`<=`、`>`、`>=`、`=`、`<>`、`in`、`not_in`、`like`、`not_like`。与 `like` 或 `not_like` 搭时，可使用 `%` 匹零个或多个字符。
`order_by`	array	结果排序规则。可选。可使用与 `filters` 相同的字段进行排序，排序方向为 `asc`（升序）或 `desc`（降序）。多个排序规则使用逗号分隔，单次请求最多设置 3 条排序规则。
`tag`	string	自定义任务标识。可选，最多 255 个字符。用于在请求与响应之间匹任务，指定的值会在响应的 `data` 对象中返回。

`filters` 示例

json

[
  {
    "filters": [
      ["domain", "like", "%seo%"],
      "and",
      ["metrics.organic.pos_1", ">", 200]
    ]
  }
]

`order_by` 示例

json

[
  {
    "order_by": [
      "metrics.organic.pos_1,desc",
      "domain,asc"
    ]
  }
]

分页说明

获取较少结果时，可通过 offset 分页。
获取大量结果时，应使用响应中的 offset_token。
使用 offset_token 发起后续请求时，除 offset_token 外的参数保持不变。
每次后续请求都应使用上一次响应返回的最新 offset_token。

响应结构

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

顶层响应字段

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

任务字段

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

`result` 字段

字段	类型	说明
`total_count`	integer	数据库中符合请求条件的结果总数。
`items_count`	integer	本次返回的 `items` 数量。
`offset`	integer	请求中指定的结果偏移量。
`offset_token`	string	获取后续结果的令牌。
`items`	array	域名及排名、流量、WHOIS 和外链数据。

`items` 域名字段

字段	类型	说明
`domain`	string	域名。
`created_datetime`	string	域名首次注册的日期和时间，采用 ISO 8601 格式，例如 `1997-03-29 03:00:00 +00:00`。
`changed_datetime`	string	WHOIS 域名记录最近一次修改的日期和时间。
`expiration_datetime`	string	域名预计到期的日期和时间。
`updated_datetime`	string	域名最近一次更新的日期和时间。
`first_seen`	string	本平台爬虫首次发现该域名的日期和时间，采用 UTC 格式 `yyyy-mm-dd hh-mm-ss +00:00`。
`epp_status_codes`	array	域名注册的 EPP 状态码。
`tld`	string	顶级域名，例如 `com`。
`registered`	boolean	域名是否已注册。为 `false` 时表示域名注册已过期。过期域名只会在数据库中保留较短时间。
`registrar`	string / null	域名注册商。为 `null` 时表示注册商未知。
`metrics`	object	域名的排名与流量指标。
`backlinks_info`	object	域名的外链统计信息。

`metrics` 排名与流量指标

`metrics.organic`

表示自然搜索结果中的排名与流量数据。

字段	类型	说明
`pos_1`	integer	域名排名第 1 的自然搜索结果数量。
`pos_2_3`	integer	域名排名第 2–3 名的自然搜索结果数量。
`pos_4_10`	integer	域名排名第 4–10 名的自然搜索结果数量。
`pos_11_20`	integer	域名排名第 11–20 名的自然搜索结果数量。
`pos_21_30`	integer	域名排名第 21–30 名的自然搜索结果数量。
`pos_31_40`	integer	域名排名第 31–40 名的自然搜索结果数量。
`pos_41_50`	integer	域名排名第 41–50 名的自然搜索结果数量。
`pos_51_60`	integer	域名排名第 51–60 名的自然搜索结果数量。
`pos_61_70`	integer	域名排名第 61–70 名的自然搜索结果数量。
`pos_71_80`	integer	域名排名第 71–80 名的自然搜索结果数量。
`pos_81_90`	integer	域名排名第 81–90 名的自然搜索结果数量。
`pos_91_100`	integer	域名排名第 91–100 名的自然搜索结果数量。
`etv`	float	预计自然搜索流量。根据域名排名的点击率（CTR）与搜索量计算，表示预计的月度自然流量。
`count`	integer	含该域名的自然搜索结果总数。
`estimated_paid_traffic_cost`	float	预计付费流量成本。根据自然搜索 `etv` 与付费点击成本（CPC）估算，将当前预计自然流量转化为搜索广告流量所需的月度成本。

`metrics.paid`

表示付费搜索结果中的排名与流量数据。

字段	类型	说明
`pos_1`	integer	域名排名第 1 的付费搜索结果数量。
`pos_2_3`	integer	域名排名第 2–3 名的付费搜索结果数量。
`pos_4_10`	integer	域名排名第 4–10 名的付费搜索结果数量。
`pos_11_20`	integer	域名排名第 11–20 名的付费搜索结果数量。
`pos_21_30`	integer	域名排名第 21–30 名的付费搜索结果数量。
`pos_31_40`	integer	域名排名第 31–40 名的付费搜索结果数量。
`pos_41_50`	integer	域名排名第 41–50 名的付费搜索结果数量。
`pos_51_60`	integer	域名排名第 51–60 名的付费搜索结果数量。
`pos_61_70`	integer	域名排名第 61–70 名的付费搜索结果数量。
`pos_71_80`	integer	域名排名第 71–80 名的付费搜索结果数量。
`pos_81_90`	integer	域名排名第 81–90 名的付费搜索结果数量。
`pos_91_100`	integer	域名排名第 91–100 名的付费搜索结果数量。
`etv`	float	预计付费搜索月流量，根据域名排名的 CTR 与搜索量计算。
`count`	integer	含该域名的付费搜索结果总数。
`estimated_paid_traffic_cost`	float	预计月度付费搜索流量成本，根据 `etv` 和 CPC 估算。

`backlinks_info` 外链字段

字段	类型	说明
`referring_domains`	integer	引荐域名数量。
`referring_main_domains`	integer	引荐主域名数量。
`referring_pages`	integer	引荐页面数量。
`dofollow`	integer	`dofollow` 外链数量。
`backlinks`	integer	外链总数 `dofollow` 和 `nofollow` 外链。
`time_update`	string	外链数据更新时间，采用 UTC 格式，例如 `2019-11-15 12:57:46 +00:00`。

请求示例

curl

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/domain_analytics/whois/overview/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "limit": 10,
      "filters": [
        ["domain", "like", "%seo%"],
        "and",
        ["metrics.organic.pos_1", ">", 200]
      ],
      "order_by": [
        "metrics.organic.pos_1,desc"
      ],
      "tag": "domain-overview-demo"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/domain_analytics/whois/overview/live"

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

# POST 请求体是 JSON 数组
payload = [
    {
        "limit": 10,
        "filters": [
            ["domain", "like", "%seo%"],
            "and",
            ["metrics.organic.pos_1", ">", 200],
        ],
        "order_by": ["metrics.organic.pos_1,desc"],
    }
]

response = requests.post(url, headers=headers, json=payload)
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 response = await axios.post(
  "https://api.seermartech.cn/v3/domain_analytics/whois/overview/live",
  [
    {
      limit: 10,
      filters: [
        ["domain", "like", "%seo%"],
        "and",
        ["metrics.organic.pos_1", ">", 200],
      ],
      order_by: ["metrics.organic.pos_1,desc"],
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

console.log(response.data);

响应示例

json

{
  "version": "0.1.20260327",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "10.8848 sec.",
  "cost": 0.102,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "10.8848 sec.",
      "cost": 0.102,
      "result_count": 1,
      "path": [
        "v3",
        "domain_analytics",
        "whois",
        "overview",
        "live"
      ],
      "data": {
        "api": "domain_analytics",
        "function": "overview",
        "se": "whois",
        "limit": 2,
        "filters": [
          ["domain", "like", "%seo%"]
        ]
      },
      "result": [
        {
          "total_count": 2,
          "items_count": 2,
          "offset": 0,
          "offset_token": "eyJvZmZzZXQiOjJ9",
          "items": [
            {
              "domain": "example.com",
              "created_datetime": "1997-03-29 03:00:00 +00:00",
              "changed_datetime": "2021-01-14 08:36:28 +00:00",
              "expiration_datetime": "2028-11-26 17:21:23 +00:00",
              "updated_datetime": "2021-01-29 13:59:38 +00:00",
              "first_seen": "2019-11-15 12:57:46 +00:00",
              "epp_status_codes": [
                "clientTransferProhibited"
              ],
              "tld": "com",
              "registered": true,
              "registrar": "Example Registrar, Inc.",
              "metrics": {
                "organic": {
                  "pos_1": 14846707,
                  "pos_2_3": 19552816,
                  "pos_4_10": 106681794,
                  "pos_11_20": 138312433,
                  "pos_21_30": 82907142,
                  "pos_31_40": 44293544,
                  "pos_41_50": 23471005,
                  "pos_51_60": 12764235,
                  "pos_61_70": 7289769,
                  "pos_71_80": 4446429,
                  "pos_81_90": 2834310,
                  "pos_91_100": 1447607,
                  "etv": 15370164717.398664,
                  "count": 458847791,
                  "estimated_paid_traffic_cost": 9947921864.140717
                },
                "paid": {
                  "pos_1": 51,
                  "pos_2_3": 4,
                  "pos_4_10": 1,
                  "pos_11_20": 0,
                  "pos_21_30": 0,
                  "pos_31_40": 0,
                  "pos_41_50": 0,
                  "pos_51_60": 0,
                  "pos_61_70": 0,
                  "pos_71_80": 0,
                  "pos_81_90": 0,
                  "pos_91_100": 0,
                  "etv": 461009.10263210535,
                  "count": 56,
                  "estimated_paid_traffic_cost": 8890.541761744767
                }
              },
              "backlinks_info": {
                "referring_domains": 20775079,
                "referring_main_domains": 15508091,
                "referring_pages": 26854913222,
                "dofollow": 23047187966,
                "backlinks": 36153043000,
                "time_update": "2026-03-20 00:46:21 +00:00"
              }
            }
          ]
        }
      ]
    }
  ]
}

实用场景

筛选高自然排名域名，定位在目标中排名靠前的域名，用于竞品发现和行业头部网站分析。
评估域名自然流量价值，结合 etv 与 estimated_paid_traffic_cost 估算 SEO 流量规模及广告替代成本，为和投放预算分提供依据。
分析竞品外链规模，比较 referring_domains、referring_pages 和 backlinks，识别竞争对手的链接建设强度与潜在资源。
监控域名注册状态，利用 created_datetime、expiration_datetime、registered 和 EPP 状态码跟踪域名生命周期，支持域名资产管理。
批量构建域名数据库，通过 limit、offset 或 offset_token 分页获取符合条件的域名，支持竞品库、行业名录和 SEO 研究数据集建设。

WHOIS 域名概览（实时） ​

计费说明 ​

请求参数 ​

filters 示例 ​

order_by 示例 ​

分页说明 ​

响应结构 ​

顶层响应字段 ​

任务字段 ​

result 字段 ​

items 域名字段 ​

metrics 排名与流量指标 ​

metrics.organic ​

metrics.paid ​

backlinks_info 外链字段 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应示例 ​

实用场景 ​

WHOIS 域名概览（实时）

计费说明

请求参数

`filters` 示例

`order_by` 示例

分页说明

响应结构

顶层响应字段

任务字段

`result` 字段

`items` 域名字段

`metrics` 排名与流量指标

`metrics.organic`

`metrics.paid`

`backlinks_info` 外链字段

请求示例

curl

Python

TypeScript

响应示例

实用场景