SeerMarTech API 文档

主题

Bing 批量流量预估（实时） ​

接口说明 ​

该接口用于批量获取最多 1,000 个目标对象的预估月度流量，支持以下类型：

  • 域名
  • 子域名
  • 页面 URL

除自然搜索流量预估外，响应中还会分别返回以下结果类型的流量数据：

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

流量值 etv 的计算逻辑为：目标对象在对应搜索结果类型下所排名的 点击率（CTR） × 搜索量 之和。

请求方式 ​

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

计费说明 ​

该接口按请求计费。

参考价：原文未提供固定单价，无法直接换算。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制 ​

  • 每分钟最多可发起 2000 次 API 调用
  • 同时并发请求上限为 30

请求体格式 ​

所有 POST 数据需使用 JSON（UTF-8）格式提交。 请求体为 JSON 数组，格式如下：

json
[
 {
 "targets": [
 "example.com",
 "blog.example.com",
 "https://www.example.com/page/"
 ],
 "location_code": 2840,
 "language_code": "en",
 "item_types": [
 "organic",
 "paid"
 ]
 }
]

请求参数 ​

字段名类型说明
targetsarray目标域名、子域名或页面列表。填。域名和子域名不得 https:// 与 www.；页面使用完整绝对 URL， https:// 和 www.。最多可提交 1000 个目标。
location_namestring地区名。当未传 location_code 时填。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用地区。注意：当前支持美国。示例：United States
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 的类型，结果会按数组中的第一个类型排序。
ignore_synonymsboolean是否忽略高度相似。可选。设为 true 时返回核心，排除高度相似。默认值：false
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本次请求总费用
tasks_countintegertasks 数组中的任务数量
tasks_errorinteger返回错误的任务数量
tasksarray任务数组

tasks 数组字段 ​

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

result 数组字段 ​

字段名类型说明
se_typestring搜索引擎类型
location_codeinteger请求中的地区编码；无数据时为 null
language_codestring请求中的语言编码；无数据时为 null
total_countinteger数据库中与本次请求的结果总量
items_countintegeritems 数组中返回的数量
itemsarray流量预估结果列表

items 数组字段 ​

字段名类型说明
se_typestring搜索引擎类型
targetstring请求中的目标对象
metricsobject该目标的流量指标数据

metrics 字段说明 ​

metrics.organic 自然搜索流量 ​

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

metrics.paid 付费搜索流量 ​

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

metrics.local_pack 本地流量 ​

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

请求示例 ​

cURL ​

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

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/bing/bulk_traffic_estimation/live"
payload = [
 {
 "targets": [
 "example.com",
 "cnn.com",
 "forbes.com"
 ],
 "location_name": "United States",
 "language_name": "English",
 "item_types": [
 "organic",
 "paid"
 ]
 }
]
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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

TypeScript ​

typescript
import axios from "axios";

// 请求体为 JSON 数组
const postArray = [
 {
 targets: [
 "example.com",
 "cnn.com",
 "forbes.com"
 ],
 location_name: "United States",
 language_name: "English",
 item_types: [
 "organic",
 "paid"
 ]
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/bing/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
{
 "version": "0.1.20220216",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1286 sec.",
 "cost": 0.0103,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "bulk_traffic_estimation",
 "se_type": "bing",
 "targets": [
 "example.com",
 "cnn.com",
 "forbes.com"
 ],
 "location_code": 2840,
 "language_code": "en",
 "item_types": [
 "organic",
 "paid"
 ]
 },
 "result": [
 {
 "se_type": "bing",
 "location_code": 2840,
 "language_code": "en",
 "total_count": 3,
 "items_count": 3,
 "items": [
 {
 "se_type": "bing",
 "target": "example.com",
 "metrics": {
 "organic": {
 "etv": 1200.45,
 "count": 530
 },
 "paid": {
 "etv": 85.12,
 "count": 47
 },
 "featured_snippet": {
 "etv": 33.7,
 "count": 12
 },
 "local_pack": {
 "etv": 10.5,
 "count": 4
 }
 }
 }
 ]
 }
 ]
 }
 ]
}

错误处理 ​

建议在接时同时处理顶层状态码和任务级状态码：

  • 顶层 status_code：表示整个请求是否成功
  • tasks[].status_code：表示某个任务是否成功

常见处理建议：

  1. 检查 HTTP 状态码是否正常
  2. 再检查顶层 status_code 是否为成功状态
  3. 遍历 tasks，检查每个任务的 status_code
  4. 对空结果、参数错误、额限制、并发限等做重试或告警

完整错误码与状态说明可参考：

  • /v3/appendix/errors

使用说明补 ​

  • 域名、子域名不要带协议头和 www.
  • 页面传完整 URL
  • 当前地区支持美国
  • 单次最多提交 1000 个目标
  • 如需控制结果类型，可通过 item_types 保留指定维度
  • 若 item_types 中首项不是 organic，结果排序会优按该类型处理

实用场景 ​

  • 批量评估竞争对手流量盘子：一次提交多个竞争域名，快速比较在 Bing 自然流量、付费流量和特殊结果位上的规模差异。
  • 筛选高价值合作站点：对候选媒体、联盟站或目录站批量估算搜索流量，判断投放、换链或合作价值。
  • 监控重点页面搜索表现：直接提交页面 URL，评估落地页在 Bing 上的自然流量与特殊展示位流量，帮助优化页面选题和结构。
  • 拆分流量来源结构：分别查看 organic、paid、featured_snippet、local_pack 的 etv，识别目标站点更依赖哪类搜索。
  • 做市场前的 SERP 竞争摸底：在美国市场场景下，批量估算行业头部站点流量规模，为 SEO 立项、预算分和竞品优级提供依据。

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

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