域名 Whois 概览（实时）

接口说明

该接口用于查询域名 Whois 信息，并附带以下增强数据：

外链统计数据
自然搜索排名与流量数据
付费搜索排名与流量数据

你可以通过请求参数筛选符合条件的域名，并按需控制返回数量、排序方式与分页方式。

请求方式

POST https://api.seermartech.cn/v3/domain_analytics/whois/overview/live

计费说明

按请求计费。原文未提供固定单价，因此无法换算参考人民币价格。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

所有 POST 数据需使用 UTF-8 编码的 JSON 格式
请求体为 JSON 数组：[{ ... }]
最高支持 2000 次 API 调用/分钟

请求参数

以下为任务字段说明。

字段名	类型	说明
`limit`	integer	返回域名的最大数量。可选；默认值：`100`；最大值：`1000`
`offset`	integer	返回结果的偏移量。可选；默认值：`0`。例如设置为 `10` 时，会跳过前 10 条 `items`，从后续结果开始返回。注意：建议在获取不 10,000 条结果时使用；若需获取 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 格式

filters 是一个数组，单个条件通常写为：

json

["字段路径", "运算符", "值"]

多个条件之间通过 "and" 或 "or" 连接，例如：

json

[
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", ">", 200]
]

order_by 格式

order_by 为数组，每项格式通常为：

json

["字段路径,排序方向"]

例如：

json

["metrics.organic.pos_1,desc"]

响应结构

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

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码。完整错误码参考 `/v3/appendix/errors`
`status_message`	string	通用状态信息。完整状态说明参考 `/v3/appendix/errors`
`time`	string	执行耗时，单位：秒
`cost`	float	本次请求总费用，单位：USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`tasks`	array	任务结果数组

tasks 数组中的字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000`-`60000`；完整错误码参考 `/v3/appendix/errors`
`status_message`	string	任务状态说明
`time`	string	任务执行耗时，单位：秒
`cost`	float	单个任务费用，单位：USD
`result_count`	integer	`result` 数组中的数量
`path`	array	URL 路径
`data`	object	与请求中提交参数一致的回显数据
`result`	array	获取结果数组

result 数组中的字段

字段名	类型	说明
`total_count`	integer	数据库中与请求匹的结果总数
`items_count`	integer	`items` 数组返回的结果数量
`offset`	integer	本次请求使用的偏移量
`offset_token`	object	后续分页令牌。将用于新的请求，可继续获取后续结果；每次任务的 `offset_token` 唯一
`items`	array	域名结果列表

items 字段说明

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

metrics.organic 字段说明

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

字段名	类型	说明
`pos_1`	integer	自然搜索中排名第 1 的 SERP 数量
`pos_2_3`	integer	自然搜索中排名 2-3 的 SERP 数量
`pos_4_10`	integer	自然搜索中排名 4-10 的 SERP 数量
`pos_11_20`	integer	自然搜索中排名 11-20 的 SERP 数量
`pos_21_30`	integer	自然搜索中排名 21-30 的 SERP 数量
`pos_31_40`	integer	自然搜索中排名 31-40 的 SERP 数量
`pos_41_50`	integer	自然搜索中排名 41-50 的 SERP 数量
`pos_51_60`	integer	自然搜索中排名 51-60 的 SERP 数量
`pos_61_70`	integer	自然搜索中排名 61-70 的 SERP 数量
`pos_71_80`	integer	自然搜索中排名 71-80 的 SERP 数量
`pos_81_90`	integer	自然搜索中排名 81-90 的 SERP 数量
`pos_91_100`	integer	自然搜索中排名 91-100 的 SERP 数量
`etv`	float	预估自然月流量。基于搜索量与 CTR 综合估算
`count`	integer	含该域名的自然搜索 SERP 总数
`estimated_paid_traffic_cost`	float	将自然流量等价换算为付费投放所需的预估月成本，单位：USD

metrics.paid 字段说明

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

字段名	类型	说明
`pos_1`	integer	付费搜索中排名第 1 的 SERP 数量
`pos_2_3`	integer	付费搜索中排名 2-3 的 SERP 数量
`pos_4_10`	integer	付费搜索中排名 4-10 的 SERP 数量
`pos_11_20`	integer	付费搜索中排名 11-20 的 SERP 数量
`pos_21_30`	integer	付费搜索中排名 21-30 的 SERP 数量
`pos_31_40`	integer	付费搜索中排名 31-40 的 SERP 数量
`pos_41_50`	integer	付费搜索中排名 41-50 的 SERP 数量
`pos_51_60`	integer	付费搜索中排名 51-60 的 SERP 数量
`pos_61_70`	integer	付费搜索中排名 61-70 的 SERP 数量
`pos_71_80`	integer	付费搜索中排名 71-80 的 SERP 数量
`pos_81_90`	integer	付费搜索中排名 81-90 的 SERP 数量
`pos_91_100`	integer	付费搜索中排名 91-100 的 SERP 数量
`etv`	float	预估付费月流量。基于搜索量与 CTR 综合估算
`count`	integer	含该域名的付费搜索 SERP 总数
`estimated_paid_traffic_cost`	float	预估付费月流量成本，单位：USD

backlinks_info 字段说明

字段名	类型	说明
`referring_domains`	integer	引用域名数量
`referring_main_domains`	integer	引用主域名数量
`referring_pages`	integer	引用页面数量
`dofollow`	integer	dofollow 外链数量
`backlinks`	integer	外链总数， dofollow 与 nofollow
`time_update`	string	外链数据更新时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +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": "whois-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"
}
data = [
 {
 "limit": 10,
 "filters": [
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", ">", 200]
 ],
 "order_by": [
 "metrics.organic.pos_1,desc"
 ],
 "tag": "whois-overview-demo"
 }
]

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

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 limit: 10,
 filters: [
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", ">", 200]
 ],
 order_by: [
 "metrics.organic.pos_1,desc"
 ],
 tag: "whois-overview-demo"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/domain_analytics/whois/overview/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);
});

响应示例

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": [
 {
 "data": {
 "api": "domain_analytics",
 "function": "overview",
 "se": "whois",
 "limit": 2,
 "filters": []
 },
 "result": [
 {
 "items": [
 {
 "tld": "com",
 "registered": true,
 "registrar": "MarkMonitor 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"
 }
 },
 {
 "domain": "facebook.com",
 "created_datetime": "1997-03-29 03:00:00 +00:00",
 "changed_datetime": "2020-03-10 16:53:59 +00:00",
 "expiration_datetime": "2028-03-30 01:00:00 +00:00",
 "updated_datetime": "2021-06-11 16:57:33 +00:00",
 "first_seen": "2020-10-06 21:00:00 +00:00",
 "epp_status_codes": [],
 "tld": "com",
 "registered": true,
 "registrar": null,
 "metrics": {
 "organic": {
 "pos_1": 8110835,
 "pos_2_3": 38399739,
 "pos_4_10": 113875984,
 "pos_11_20": 77274410,
 "pos_21_30": 50588781,
 "pos_31_40": 35459009,
 "pos_41_50": 24597152,
 "pos_51_60": 17605929,
 "pos_61_70": 12843898,
 "pos_71_80": 9390813,
 "pos_81_90": 6893761,
 "pos_91_100": 3712026,
 "etv": 12907263277.442297,
 "count": 398752337,
 "estimated_paid_traffic_cost": 10807286334.484005
 },
 "paid": {
 "pos_1": 1695,
 "pos_2_3": 109,
 "pos_4_10": 25,
 "pos_11_20": 1,
 "pos_21_30": 1,
 "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": 458496.5912024081,
 "count": 1831,
 "estimated_paid_traffic_cost": 1079915.6122864299
 }
 },
 "backlinks_info": {
 "referring_domains": 39768060,
 "referring_main_domains": 30300262,
 "referring_pages": 56477948556,
 "dofollow": 46777568316,
 "backlinks": 74973720695,
 "time_update": "2026-03-18 06:31:50 +00:00"
 }
 }
 ]
 }
 ]
 }
 ]
}

错误处理

顶层 status_code 表示整体请求状态
tasks[].status_code 表示单个任务状态
完整错误码与状态说明请参考 /v3/appendix/errors

建议：

对网络错误、时、空结果、参数错误、分页令牌失效等做好异常处理
批量翻页获取大结果集时，优使用 offset_token，深分页导致时

使用建议

小批量结果获取：优使用 limit + offset
大结果集翻页：使用 offset_token
高效筛选：优通过 filters 缩小范围，再通过 order_by 排序
结果追踪：为每个请求设置 tag，方便与任务、客户或项目编号

实用场景

筛选高价值竞品域名：按自然排名、预估流量和外链规模过滤域名，快速建立竞品观察名单。
挖掘过期或异常域名机会：结合 registered、到期时间和 Whois 变更时间，发现可能可回收、可监控或存在波动的域名资产。
评估域名 SEO 资产质量：同时查看 Whois、自然流量、付费流量和外链数据，快速判断某域名的历史价值与搜索表现。
监控行业头部站点变化：按注册商、TLD、排名区间或外链规模筛选站点，持续跟踪重点行业域名的状态变化。
建立潜在合作与投放名单：基于域名搜索可见度、付费流量能力和外链影响力，筛选适合合作、采购或广告投放的目标网站。

域名 Whois 概览（实时） ​

接口说明 ​

请求参数 ​

过滤与排序 ​

filters 格式 ​

order_by 格式 ​

响应结构 ​

顶层字段 ​

tasks 数组中的字段 ​

result 数组中的字段 ​

items 字段说明 ​

metrics.organic 字段说明 ​

metrics.paid 字段说明 ​

backlinks_info 字段说明 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

错误处理 ​

使用建议 ​

实用场景 ​

域名 Whois 概览（实时）

接口说明

请求参数

过滤与排序

filters 格式

order_by 格式

响应结构

顶层字段

tasks 数组中的字段

result 数组中的字段

items 字段说明

metrics.organic 字段说明

metrics.paid 字段说明

backlinks_info 字段说明

请求示例

cURL

Python

TypeScript

响应示例

错误处理

使用建议

实用场景