SeerMarTech API 文档

主题

域名排名总览（旧版）实时接口 ​

接口说明 ​

该接口用于查询指定域名在自然搜索与付费搜索中的排名和流量概览数据。你可以基于返回结果查看：

  • 域名在 SERP 中的排名分布
  • 自然搜索的预估月流量
  • 付费搜索的预估月流量
  • 域名在自然/付费结果中的波动（新增、上升、下降、丢失）

注意：本页描述的是旧版接口结构（Legacy）。平台 API 已在 2022-03-19 更新请求与响应结构，但该旧版接口仍保持容支持。新版本可参考对应新版文档。

请求方式： POST接口地址： https://api.seermartech.cn/v3/dataforseo_labs/domain_rank_overview/live

计费与调用限制 ​

  • 本接口按请求计费
  • 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
  • 调用频率上限：每分钟最多 2000 次 API 调用
  • POST 数据需使用 JSON（UTF-8）
  • 请求体格式为 JSON 数组：[{ ... }]

请求参数 ​

以下为任务参数说明。

字段名类型说明
targetstring填。目标网站域名。请勿 https:// 和 www.
location_namestring可选。地区名。使用该字段时无需再传 location_code。可通过 /v3/dataforseo_labs/locations_and_languages 获取支持的地区列表。忽略该字段时，返回所有可用地区的数据。示例：United Kingdom
location_codeinteger可选。地区编码。使用该字段时无需再传 location_name。可通过 /v3/dataforseo_labs/locations_and_languages 获取支持的地区列表。忽略该字段时，返回所有可用地区的数据。示例：2840
language_namestring可选。语言名。使用该字段时无需再传 language_code。可通过 /v3/dataforseo_labs/locations_and_languages 获取支持的语言列表。忽略该字段时，返回所有可用语言的数据。示例：English
language_codestring可选。语言代码。使用该字段时无需再传 language_name。可通过 /v3/dataforseo_labs/locations_and_languages 获取支持的语言列表。忽略该字段时，返回所有可用语言的数据。示例：en
limitinteger可选。返回结果的最大数量。默认值：100；最大值：1000
offsetinteger可选。结果偏移量。默认值：0。例如设置为 10 时，将跳过结果数组中的前 10 项，从后续项开始返回
tagstring可选。自定义任务标识，用于请求和结果匹。最大长度 255 字符。响应中会在 data 对象里返回该值

响应结构 ​

接口返回 JSON 数据，顶层 tasks 数组，每个任务对应一组执行结果。

顶层字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码。完整错误码请参考 /v3/appendix/errors
status_messagestring通用状态信息
timestring执行耗时，单位秒
costfloat本次请求总成本，单位 USD
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中执行失败的任务数量
tasksarray任务结果数组

tasks[] 字段 ​

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

result[] 字段 ​

字段名类型说明
targetstring请求中的目标域名
location_codeinteger请求中的地区编码
language_codestring请求中的语言代码
total_countinteger数据库中与请求匹的总结果数
items_countintegeritems 数组中返回的结果数量
itemsarray排名与流量数据

items[].metrics 指标说明 ​

metrics 表示与目标域名的排名数据， organic 和 paid 两部分。

metrics.organic 自然搜索指标 ​

字段名类型说明
pos_1integer域名排名第 1 的自然结果数量
pos_2_3integer域名排名第 2-3 位的自然结果数量
pos_4_10integer域名排名第 4-10 位的自然结果数量
pos_11_20integer域名排名第 11-20 位的自然结果数量
pos_21_30integer域名排名第 21-30 位的自然结果数量
pos_31_40integer域名排名第 31-40 位的自然结果数量
pos_41_50integer域名排名第 41-50 位的自然结果数量
pos_51_60integer域名排名第 51-60 位的自然结果数量
pos_61_70integer域名排名第 61-70 位的自然结果数量
pos_71_80integer域名排名第 71-80 位的自然结果数量
pos_81_90integer域名排名第 81-90 位的自然结果数量
pos_91_100integer域名排名第 91-100 位的自然结果数量
etvfloat预估流量。表示域名自然搜索的预估月流量，按 CTR 与搜索量乘积汇总计算
impressions_etvfloat基于量的预估流量。表示域名自然搜索的预估月流量，按 CTR 与量乘积汇总计算
countinteger含该域名的自然搜索 SERP 总数
estimated_paid_traffic_costfloat将自然流量通过付费广告获取的预估成本（USD）。通常用于估算同等流量的 PPC 成本
is_newinteger新增排名数量
is_upinteger排名上升的数量
is_downinteger排名下降的数量
is_lostinteger已丢失排名的数量

metrics.paid 付费搜索指标 ​

字段名类型说明
pos_1integer域名排名第 1 的付费结果数量
pos_2_3integer域名排名第 2-3 位的付费结果数量
pos_4_10integer域名排名第 4-10 位的付费结果数量
pos_11_20integer域名排名第 11-20 位的付费结果数量
pos_21_30integer域名排名第 21-30 位的付费结果数量
pos_31_40integer域名排名第 31-40 位的付费结果数量
pos_41_50integer域名排名第 41-50 位的付费结果数量
pos_51_60integer域名排名第 51-60 位的付费结果数量
pos_61_70integer域名排名第 61-70 位的付费结果数量
pos_71_80integer域名排名第 71-80 位的付费结果数量
pos_81_90integer域名排名第 81-90 位的付费结果数量
pos_91_100integer域名排名第 91-100 位的付费结果数量
etvfloat预估流量。表示域名付费搜索的预估月流量，按 CTR 与搜索量乘积汇总计算
impressions_etvfloat基于量的预估流量。表示域名付费搜索的预估月流量，按 CTR 与量乘积汇总计算
countinteger含该域名的付费搜索 SERP 总数
estimated_paid_traffic_costfloat预估月付费流量成本（USD），基于 etv 与 cpc 估算
is_newinteger新增排名数量
is_upinteger排名上升的数量
is_downinteger排名下降的数量
is_lostinteger已丢失排名的数量

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/domain_rank_overview/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "example.com",
 "language_name": "English",
 "location_code": 2840
 }
]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/domain_rank_overview/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "target": "example.com",
 "location_name": "United States",
 "language_name": "English"
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postArray = [
 {
 target: "example.com",
 language_name: "English",
 location_code: 2840,
 },
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/domain_rank_overview/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
 data: postArray,
})
 .then((response) => {
 // 输出结果数据
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例 ​

以下示例为原始文档的简化结构示意，返回字段可能更完整。

json
{
 "version": "0.1.20210601",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2826 sec.",
 "cost": 0.0101,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "domain_rank_overview",
 "target": "google.com",
 "language_name": "English",
 "location_code": 2840
 },
 "result": [
 {}
 ]
 }
 ]
}

错误处理 ​

建议对以下字段进行统一处理：

  • 顶层 status_code / status_message
  • 任务级 tasks[].status_code / tasks[].status_message

常见判断方式：

  • 20000：请求成功
  • 状态码：表示参数错误、权限问题、频控、余额不足或平台处理异常等

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

使用建议 ​

  • target 传裸域名，不要带协议头与 www
  • 若需要限定国家/地区与语言，优使用 location_code + language_code
  • 若希望查看量地区或语言汇总，可不传对应过滤字段
  • 结果较多时，使用 limit 与 offset 做分页拉取
  • 若需在业务系统中追踪请求，可使用 tag 透传自定义标识

实用场景 ​

  • 评估域名 SEO 可见度：查看自然搜索排名区间分布与 etv，快速判断站点整体搜索表现
  • 对比自然流量商业价值：利用 estimated_paid_traffic_cost 估算“同等自然流量若改用竞价获取”的成本
  • 监控排名波动趋势：结合 is_new、is_up、is_down、is_lost 判断站点近期排名变化与风险
  • 分析付费投放覆盖：通过 paid 部分的排名分布和预估流量，了解域名在搜索广告中的
  • 支持区域化 SEO 决策：按不同 location_code、language_code 查询，识别各市场的搜索表现差异

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

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