SeerMarTech API 文档

主题

域名 Whois 概览（旧版） ​

POST /v3/dataforseo_labs/domain_whois_overview/live

接口说明 ​

注意：本平台 Labs API 的请求与响应结构已于 2022-03-19 更新，但当前文档描述的是旧版容接口，本平台仍持续支持。 如需查看新版接口，请参考：/v3/domain_analytics/whois/overview/live/

该接口用于获取 Whois 域名数据，并补返回该域名在自然搜索与付费搜索中的排名及流量指标。 你可以通过筛选条件、排序规则、分页参数，查询符合条件的一批域名及 Whois 概览数据。

  • 请求方式：POST
  • 请求地址：https://api.seermartech.cn/v3/dataforseo_labs/domain_whois_overview/live
  • 请求体格式：JSON
  • 请求体结构：[{ ... }]

计费说明 ​

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

调用频率限制：

  • 每分钟最多 2000 次 API 调用

请求参数 ​

以下为任务对象中可用的参数说明。

字段名类型说明
limitinteger返回域名的最大数量。可选；默认值：100；最大值：1000
offsetinteger返回结果的偏移量。可选；默认值：0。例如设置为 10 时，将跳过前 10 个 items，从后续结果开始返回
filtersarray结果筛选条件数组。可选；最多支持 8 个筛选条件
order_byarray结果排序规则。可选；单次请求最多支持 3 条排序规则
tagstring用户自定义任务标识。可选；最大长度 255 字符。返回结果中的 data.tag 会原样带回，便于任务追踪

filters 说明 ​

filters 用于指定筛选条件，并通过逻辑运算符组合多个条件。

支持的逻辑连接符：

  • and
  • or

支持的比较运算符：

  • <
  • <=
  • >
  • >=
  • =
  • <>
  • in
  • not_in
  • like
  • not_like

说明：

  • like 和 not_like 支持使用 % 作为通符，表示匹任意长度字符串
  • 可组合多个条件，但总数不 8 个
  • 过滤字段可使用返回结果中的字段路径，例如：
  • domain
  • expiration_datetime
  • registered
  • metrics.organic.pos_1
  • metrics.paid.count

示例：

json
[
 ["expiration_datetime", ">", "2021-02-15 01:00:00 +00:00"],
 "and",
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", "<", 200]
]

更多筛选语法可参考 /v3/dataforseo_labs/filters。

order_by 说明 ​

order_by 用于指定排序规则，字段路径与 filters 可用字段一致。

支持排序方式：

  • asc：升序
  • desc：降序

格式示例：

json
["metrics.organic.pos_1,desc"]

多条排序规则时，使用数组传递，最多 3 条，例如：

json
[
 "metrics.organic.pos_1,desc",
 "expiration_datetime,asc"
]

响应结构 ​

接口返回 JSON 对象， tasks 数组。

顶层字段 ​

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

错误码与状态信息可参考：/v3/appendix/errors。 建议在接时做好异常与错误处理。

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000
status_messagestring任务状态描述
timestring任务执行耗时
costfloat单个任务费用，单位 USD
result_countintegerresult 数组中的数量
patharrayURL 路径
dataobject回显请求时提交的参数
resultarray结果数组

result[] 字段 ​

字段名类型说明
total_countinteger数据库中与请求条件匹的总结果数
items_countinteger当前返回的 items 数量
itemsarray域名 Whois 与搜索指标数据

items[] 字段 ​

字段名类型说明
domainstring域名
created_datetimestring域名首次注册时间，ISO 8601 格式，例如 "1997-03-29 03:00:00 +00:00"
changed_datetimestring域名记录最近变更时间，ISO 8601 格式
expiration_datetimestring域名到期时间，ISO 8601 格式
updated_datetimestring域名最近更新时间，ISO 8601 格式
first_seenstring本平台爬虫首次发现该域名的时间，UTC 格式，例如 "2019-11-15 12:57:46 +00:00"
epp_status_codesarray域名 EPP 状态码
tldstring顶级域名
registeredboolean域名是否仍处于注册状态；若为 false，表示注册已过期。注意：过期域名只会在数据库中保留较短时间
metricsobject该域名对应的搜索排名与流量指标

metrics 字段说明 ​

metrics.organic 自然搜索指标 ​

字段名类型说明
pos_1integer该域名在自然搜索中排名第 1 的 SERP 数量
pos_2_3integer排名第 2-3 的 SERP 数量
pos_4_10integer排名第 4-10 的 SERP 数量
pos_11_20integer排名第 11-20 的 SERP 数量
pos_21_30integer排名第 21-30 的 SERP 数量
pos_31_40integer排名第 31-40 的 SERP 数量
pos_41_50integer排名第 41-50 的 SERP 数量
pos_51_60integer排名第 51-60 的 SERP 数量
pos_61_70integer排名第 61-70 的 SERP 数量
pos_71_80integer排名第 71-80 的 SERP 数量
pos_81_90integer排名第 81-90 的 SERP 数量
pos_91_100integer排名第 91-100 的 SERP 数量
etvfloat预估自然月流量。按域名已排名的 CTR 与搜索量计算
impressions_etvfloat基于量计算的预估自然月流量
countinteger含该域名的自然搜索 SERP 总数
estimated_paid_traffic_costfloat若通过搜索广告获取同等自然流量，预估每月需要支付的广告成本（USD）

metrics.paid 付费搜索指标 ​

字段名类型说明
pos_1integer该域名在付费搜索中排名第 1 的 SERP 数量
pos_2_3integer排名第 2-3 的 SERP 数量
pos_4_10integer排名第 4-10 的 SERP 数量
pos_11_20integer排名第 11-20 的 SERP 数量
pos_21_30integer排名第 21-30 的 SERP 数量
pos_31_40integer排名第 31-40 的 SERP 数量
pos_41_50integer排名第 41-50 的 SERP 数量
pos_51_60integer排名第 51-60 的 SERP 数量
pos_61_70integer排名第 61-70 的 SERP 数量
pos_71_80integer排名第 71-80 的 SERP 数量
pos_81_90integer排名第 81-90 的 SERP 数量
pos_91_100integer排名第 91-100 的 SERP 数量
etvfloat预估付费月流量
impressions_etvfloat基于量计算的预估付费月流量
countinteger含该域名的付费搜索 SERP 总数
estimated_paid_traffic_costfloat该域名付费搜索月流量的预估广告成本（USD）

请求示例 ​

以下示例演示：

  • 最多返回 10 条记录
  • 筛选 expiration_datetime 晚于指定时间的域名
  • 域名中 seo
  • 自然搜索排名第 1 的 SERP 数量小于 200
  • 按 metrics.organic.pos_1 倒序排序

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/domain_whois_overview/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "limit": 10,
 "filters": [
 ["expiration_datetime", ">", "2021-02-15 01:00:00 +00:00"],
 "and",
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", "<", 200]
 ],
 "order_by": [
 "metrics.organic.pos_1,desc"
 ]
 }
]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/domain_whois_overview/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "limit": 10,
 "filters": [
 ["expiration_datetime", ">", "2021-02-15 01:00:00 +00:00"],
 "and",
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", "<", 200]
 ],
 "order_by": [
 "metrics.organic.pos_1,desc"
 ]
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postData = [
 {
 limit: 10,
 filters: [
 ["expiration_datetime", ">", "2021-02-15 01:00:00 +00:00"],
 "and",
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", "<", 200]
 ],
 order_by: [
 "metrics.organic.pos_1,desc"
 ]
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/domain_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.20210818",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.3871 sec.",
 "cost": 0.102,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "domain_whois_overview",
 "limit": 2,
 "filters": [
 ["expiration_datetime", ">", "2021-02-15 01:00:00 +00:00"],
 "and",
 ["domain", "like", "%seo%"],
 "and",
 ["metrics.organic.pos_1", "<", 200]
 ],
 "order_by": [
 "metrics.organic.pos_1,desc"
 ]
 },
 "result": [
 {
 "items": [
 {
 "tld": "jp",
 "registered": true,
 "metrics": {
 "organic": {
 "pos_1": 945,
 "pos_2_3": 2483,
 "pos_4_10": 11669,
 "pos_11_20": 12219,
 "pos_21_30": 11514,
 "pos_31_40": 11475,
 "pos_41_50": 11111,
 "pos_51_60": 10366,
 "pos_61_70": 9817,
 "pos_71_80": 9030,
 "pos_81_90": 8058,
 "pos_91_100": 6153,
 "etv": 661778.0739819999,
 "impressions_etv": 3318.80090166,
 "count": 104840,
 "estimated_paid_traffic_cost": 178460.03318715267
 },
 "paid": {
 "pos_1": 0,
 "pos_2_3": 0,
 "pos_4_10": 0,
 "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": 0,
 "impressions_etv": 0,
 "count": 0,
 "estimated_paid_traffic_cost": 0
 }
 }
 },
 {
 "domain": "houseofbruar.com",
 "created_datetime": "1998-02-02 05:00:00 +00:00",
 "changed_datetime": "2020-11-11 08:37:51 +00:00",
 "expiration_datetime": "2021-02-01 05:00:00 +00:00",
 "updated_datetime": "2021-01-27 14:52:15 +00:00",
 "first_seen": "2019-11-25 13:40:22 +00:00",
 "epp_status_codes": [],
 "tld": "com",
 "registered": true,
 "metrics": {
 "organic": {
 "pos_1": 350,
 "pos_2_3": 461,
 "pos_4_10": 2413,
 "pos_11_20": 6220,
 "pos_21_30": 6972,
 "pos_31_40": 7190,
 "pos_41_50": 7036,
 "pos_51_60": 7053,
 "pos_61_70": 6781,
 "pos_71_80": 6245,
 "pos_81_90": 5679,
 "pos_91_100": 4162,
 "etv": 205127.11125599995,
 "impressions_etv": 19896.259351139997,
 "count": 60562,
 "estimated_paid_traffic_cost": 143074.53721145738
 },
 "paid": {
 "pos_1": 16,
 "pos_2_3": 27,
 "pos_4_10": 11,
 "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": 1561.9769999999999,
 "impressions_etv": 100.04511,
 "count": 54,
 "estimated_paid_traffic_cost": 888.9673911639999
 }
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码说明 ​

  • 20000：请求成功
  • 状态码：表示请求参数错误、权限问题、额度不足或任务级异常

完整错误码列表请参考：/v3/appendix/errors

使用建议 ​

  • 当需要批量筛选特定注册状态、到期时间或域名模式的站点时，优使用 filters
  • 若需要按 SEO 价值排序，建议结合 metrics.organic.etv、metrics.organic.count、estimated_paid_traffic_cost 使用
  • 获取结果可能已过期但尚未从数据库理的域名，使用时请结合 registered 字段判断

实用场景 ​

  • 筛选即将到期的高价值域名：结合 expiration_datetime 与 metrics.organic.etv，快速发现备自然流量资产的到期域名，用于抢注、收购或投放评估。
  • 挖掘特定主题域名机会：通过 domain like "%seo%"、tld 等条件定位细分行业域名，行业研究与站群资源挖掘。
  • 评估域名历史与搜索价值：同时查看注册时间、更新时间、自然排名分布和预估流量，判断某域名是否备长期 SEO 资产。
  • 监控竞争对手域名组合：批量提取符合条件的域名，分析自然搜索与付费搜索覆盖，为竞品域名策略提供依据。
  • 建立域名优级名单：按 metrics.organic.pos_1、count、estimated_paid_traffic_cost 排序，优处理更流量和商业价值的目标域名。

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

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