SeerMarTech API 文档

主题

批量流量预估（旧版） ​

接口说明 ​

该接口用于批量获取最多 1,000 个域名的预估月度流量。除自然搜索流量外，还可分别返回以下结果类型的流量数据：

  • 付费搜索
  • 精选摘要（featured snippet）
  • 本地（local pack）

流量值基于域名在对应搜索结果类型中覆盖的集合计算，核心逻辑为：

预估流量 = CTR（点击率）× 搜索量

本接口为旧版容接口。虽然平台 API 已在 2022-03-19 调整了 本平台 Labs API 的请求与响应结构，但该旧版路径仍持续支持。如需新版结构，可参考对应新版接口文档。

请求方式 ​

POST https://api.seermartech.cn/v3/dataforseo_labs/bulk_traffic_estimation/live

计费说明 ​

该接口按请求计费。

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

调用限制 ​

  • 所有 POST 数据使用 UTF-8 编码的 JSON 格式
  • 请求体为 JSON 数组：[{ ... }]
  • 每分钟最多可发送 2000 次 API 调用

请求参数 ​

字段名类型说明
targetsarray填。目标域名列表。每个域名去掉 https:// 和 www. 前缀。数组中最多可传 1000 个域名。
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
item_typesarray可选。指定返回的搜索结果类型。若数组中除 organic 之外的类型，结果将按数组中的第一个类型排序。
tagstring可选。用户自定义任务标识，最长 255 个字符。可用于在响应中识别和匹任务，返回时会出现在响应 data 对象中。

item_types 可选值 ​

原始文档该处枚举值展示缺失。结合响应结构，本接口支持的结果类型至少：

  • organic
  • paid
  • featured_snippet
  • local_pack

如未传该字段，默认返回接口支持的结果类型。

响应结构 ​

接口返回 JSON，顶层 tasks 数组，每个任务对应请求与结果信息。

顶层字段 ​

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

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000，详见 /v3/appendix/errors
status_messagestring任务状态信息
timestring单任务执行耗时，单位秒
costfloat单任务费用，单位 USD
result_countintegerresult 数组中的数量
patharray请求路径
dataobject与请求中提交的参数基本一致
resultarray结果数组

result[] 字段 ​

字段名类型说明
targetstring请求中的目标域名
location_codeinteger请求中的位置编码；如无数据则为 null
language_codestring请求中的语言编码；如无数据则为 null
total_countinteger数据库中与本次请求的结果总量
items_countintegeritems 数组中返回的结果数量
metricsobject指定域名对应的流量指标数据

metrics 字段 ​

metrics.organic ​

字段名类型说明
etvfloat预估自然搜索月流量
countinteger含该域名的自然搜索 SERP 总数

metrics.paid ​

字段名类型说明
etvfloat预估付费搜索月流量
countinteger含该域名的付费搜索 SERP 总数
字段名类型说明
etvfloat预估精选摘要流量
countinteger含该域名的精选摘要结果总数

metrics.local_pack ​

字段名类型说明
etvfloat预估本地流量
countinteger含该域名的本地结果总数

说明：上述 etv 均为月度预估流量，按搜索量与点击率模型计算得出。

请求示例 ​

curl ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/bulk_traffic_estimation/live" \
 --header "Authorization: Bearer smt_live_YOUR_KEY" \
 --header "Content-Type: application/json" \
 --data-raw '[
 {
 "targets": [
 "cnn.com",
 "forbes.com",
 "example.com"
 ],
 "location_code": 2840,
 "language_code": "en",
 "item_types": [
 "organic",
 "paid"
 ],
 "tag": "bulk-traffic-demo"
 }
 ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/bulk_traffic_estimation/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

payload = [
 {
 "targets": [
 "cnn.com",
 "forbes.com",
 "example.com"
 ],
 "location_name": "United States",
 "language_name": "English",
 "item_types": [
 "organic",
 "paid"
 ],
 "tag": "bulk-traffic-demo"
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postArray = [
 {
 targets: ["cnn.com", "forbes.com", "example.com"],
 location_name: "United States",
 language_name: "English",
 item_types: ["organic", "paid"],
 tag: "bulk-traffic-demo"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/bulk_traffic_estimation/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 有部分缺失，以下为按原始结构整理后的示意示例。

json
{
 "version": "0.1.20210917",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2930 sec.",
 "cost": 0.0103,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2811 sec.",
 "cost": 0.0103,
 "result_count": 3,
 "path": [
 "v3",
 "dataforseo_labs",
 "bulk_traffic_estimation",
 "live"
 ],
 "data": {
 "api": "dataforseo_labs",
 "function": "bulk_traffic_estimation",
 "targets": [
 "cnn.com",
 "forbes.com",
 "example.com"
 ],
 "location_code": 2840,
 "language_code": "en",
 "item_types": [
 "organic",
 "paid"
 ],
 "tag": "bulk-traffic-demo"
 },
 "result": [
 {
 "target": "cnn.com",
 "location_code": 2840,
 "language_code": "en",
 "total_count": 1,
 "items_count": 1,
 "metrics": {
 "organic": {
 "etv": 123456.78,
 "count": 56789
 },
 "paid": {
 "etv": 2345.67,
 "count": 890
 },
 "featured_snippet": {
 "etv": 345.67,
 "count": 120
 },
 "local_pack": {
 "etv": 89.12,
 "count": 34
 }
 }
 },
 {
 "target": "forbes.com",
 "location_code": 2840,
 "language_code": "en",
 "total_count": 1,
 "items_count": 1,
 "metrics": {
 "organic": {
 "etv": 98765.43,
 "count": 45678
 },
 "paid": {
 "etv": 1234.56,
 "count": 654
 },
 "featured_snippet": {
 "etv": 210.11,
 "count": 98
 },
 "local_pack": {
 "etv": 45.67,
 "count": 21
 }
 }
 }
 ]
 }
 ]
}

状态码与错误处理 ​

  • 顶层 status_code 表示整个请求的执行状态
  • tasks[].status_code 表示单个任务的执行状态
  • 建议同时校验：
  • HTTP 状态码
  • 顶层 status_code
  • 任务级 tasks[].status_code

常见成功状态：

  • 20000：成功

完整错误码与信息请参考：

  • /v3/appendix/errors

由于该接口支持批量域名查询，建议在业务侧做好以下异常处理：

  • 缺少填参数，如未传 targets
  • location_name/location_code 与 language_name/language_code 未正确提供
  • 域名格式不符合要求（协议头或 www.）
  • 批量数量限（ 1000 个域名）
  • 高频调用触发限流
  • 任务级部分成功、部分失败的

使用说明与注意事项 ​

  1. targets 中的域名使用裸域名或普通主机名，不要：
  • https://
  • http://
  • www.

  1. 若同时传 location_name 和 location_code，建议优保持语义一致，位置与语言组合无效。

  2. item_types 可用于只查看某一类搜索结果来源，例如：

  • 只看自然流量：["organic"]
  • 同时看自然与付费：["organic", "paid"]

  1. 如果 item_types 的第一个不是 organic，返回结果会优按该类型排序。

  2. 当请求的数据在对应区域或语言下不存在时，部分返回字段可能为 null 或结果数量较少。

实用场景 ​

  • 批量评估竞品流量体量：一次对比多个竞争域名在同一国家/语言下的自然与付费流量预估，快速判断市场格局与竞争强度。
  • 筛选高价值投放对象：分析候选媒体站点或合作站点的自然流量、付费流量和 SERP 覆盖规模，渠道合作与广告投放决策。
  • 监控品牌与竞品的搜索能见度：持续拉取核心品牌及竞品域名的 organic、featured_snippet、local_pack 指标，识别流量来源结构变化。
  • 评估本地化 SEO 表现：针对不同国家、语言组合获取域名在本地和自然结果中的流量预估，判断区域化 SEO 布局效果。
  • 构建域名优级评分模型：将 etv 与 count 结合业务指标，为销售线索筛选、站点收购评估或合作排序提供量化依据。

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

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