SeerMarTech API 文档

主题

数据库 ​

概述 ​

这是一个历史版本页面。更新后的数据库文档请参考新版文档路径。

数据库收录了 30 亿条搜索词，并附带数据，例如：

  • 搜索量趋势
  • CPC（平均点击成本）
  • 竞争度
  • 展现量指标
  • 补信息

该数据库支持 JSON 和 CSV 两种格式。

计费说明 ​

数据库费用取决于所请求数据集的规模以及地域参数。

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

数据字段说明 ​

下表说明数据库中每条记录的字段结构。

字段名类型说明
keywordstring本身，采用 UTF-8 编码
locationinteger地区编码，对应目标地区的唯一标识
languagestring语言编码，对应目标地区下可用语言的唯一标识
spellstring搜索引擎自动纠错后的；如果搜索引擎对原词进行了修正并返回结果，则这里返回修正后的词及纠错信息
spell_typestring自动纠错类型，可选值：did_you_mean、showing_results_for、no_results_found_for
keyword_infoarray / object返回的核心数据
impressions_infoarray / object返回的广告展现数据
bing_keyword_infoarray / object基于 Bing Ads 的数据部分地区和语言支持
extraarray / object的附加信息

获取地区与语言列表 ​

可通过以下接口获取可用的 location_code 和 language_code：

/v3/dataforseo_labs/locations_and_languages

对应请求地址示例：

https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages

示例：

  • 2840 表示 United States
  • en 表示 English

keyword_info 字段说明 ​

字段名类型说明
search_volumeinteger平均月搜索量。表示指定在目标范围的大致月搜索次数
cpcfloat平均点击成本，历史统计口径，单位为 USD
competitionfloat竞争度，取值范围 0 到 1（含），基于广告数据
time_updatestring数据最后更新时间
categoriesarray商品或服务类别列表
historyarray / object月度搜索历史数据

keyword_info.time_update ​

时间格式通常为 ISO 8601，例如：

2021-03-24T04:01:47.4351095Z

旧版说明中也出现了 month/date/year hours:minutes:seconds UTC 的描述，但示例数据采用 ISO 8601，以响应返回值为准。

categories ​

表示与该的产品或服务分类。

history ​

按月份返回该在指定地区的月度搜索次数，键名格式通常为 YYYYMM。

例如：

  • 202003: 2020 年 3 月
  • 202102: 2021 年 2 月

impressions_info 字段说明 ​

该对象描述在广告投放维度下的展现、点击与成本信息。

字段名类型说明
ad_position_averagefloat广告平均展示位置
ad_position_minfloat广告最低展示位置
ad_position_maxfloat广告最高展示位置
cpc_avgfloat平均点击成本，单位为 USD
cpc_minfloat最低点击成本，单位为 USD
cpc_maxfloat最高点击成本，单位为 USD
daily_impressions_avgfloat平均每日展现量
daily_impressions_minfloat最低每日展现量
daily_impressions_maxfloat最高每日展现量
daily_clicks_avgfloat平均每日点击量
daily_clicks_minfloat最低每日点击量
daily_clicks_maxfloat最高每日点击量
bidinteger最大出价。该数据库固定以 999 出价值返回结果，以提供更的展现数据
daily_cost_avgfloat平均每日广告花费
daily_cost_minfloat最低每日广告花费
daily_cost_maxfloat最高每日广告花费
time_updatestring广告展现数据最后更新时间

impressions_info ​

这些字段反映的是广告投放层面的估算信息，适合用于评估的商业化程度、投放竞争强弱以及潜在广告消耗。

bing_keyword_info 字段说明 ​

该对象提供基于 Bing Ads 的数据。部分地区和语言支持。

字段名类型说明
search_volumeintegerBing 上过去一个月的搜索量
time_updatestring数据最后更新时间，采用 ISO 8601 格式
historyarray / object按月统计的 Bing 搜索历史数据

示例时间格式：

2020-09-12T00:07:43.0733218Z

注意：并非所有地区和语言都提供 Bing 数据。可通过 /v3/dataforseo_labs/locations_and_languages 查询支持。

extra 字段说明 ​

字段名类型说明
core_keywordstring分组中的核心词

extra.core_keyword ​

表示一组在 keyword_info 参数上相似性的中的主。

  • 如果返回值，表示该已被聚类到某个核心词组中
  • 如果返回 null，表示数据库中没有符合该聚类规则的对应核心词

JSON 数据示例 ​

以下示例展示了数据库中的 JSON 结构：

json
[
 {
 "keyword": "الر ثلاثي الابعاد",
 "location": 2818,
 "language": "ar",
 "spell": null,
 "spell_type": null,
 "keyword_info": {
 "search_volume": 720,
 "cpc": 0.015523,
 "competition": 0.019329507701600728,
 "time_update": "2021-03-24T04:01:47.4351095Z",
 "categories": null,
 "history": {
 "202003": 1000,
 "202004": 1000,
 "202005": 880,
 "202006": 1000,
 "202007": 720,
 "202008": 590,
 "202009": 480,
 "202010": 480,
 "202011": 480,
 "202012": 590,
 "202101": 590,
 "202102": 480
 }
 },
 "impressions_info": {
 "ad_position_avg": null,
 "ad_position_min": null,
 "ad_position_max": null,
 "cpc_avg": null,
 "cpc_min": null,
 "cpc_max": null,
 "daily_impressions_avg": 0,
 "daily_impressions_min": 0,
 "daily_impressions_max": 0,
 "daily_clicks_avg": 0,
 "daily_clicks_min": 0,
 "daily_clicks_max": 0,
 "bid": 999,
 "daily_cost_avg": 0,
 "daily_cost_min": 0,
 "daily_cost_max": 0,
 "time_update": "2021-03-19T14:07:03.9208731Z"
 },
 "bing_keyword_info": null,
 "extra": {
 "core_keyword": "رس ثلاثية الابعاد"
 }
 },
 {
 "keyword": "اليرة هيا",
 "location": 2818,
 "language": "ar",
 "spell": null,
 "spell_type": null,
 "keyword_info": {
 "search_volume": 720,
 "cpc": 0.009519,
 "competition": 0.0033973161202649907,
 "time_update": "2021-03-31T21:57:05.1516650Z",
 "categories": null,
 "history": {
 "202003": 2900,
 "202004": 880,
 "202005": 590,
 "202006": 590,
 "202007": 720,
 "202008": 590,
 "202009": 480,
 "202010": 390,
 "202011": 390,
 "202012": 390,
 "202101": 390,
 "202102": 880
 }
 },
 "impressions_info": {
 "ad_position_avg": null,
 "ad_position_min": null,
 "ad_position_max": null,
 "cpc_avg": null,
 "cpc_min": null,
 "cpc_max": null,
 "daily_impressions_avg": 0,
 "daily_impressions_min": 0,
 "daily_impressions_max": 0,
 "daily_clicks_avg": 0,
 "daily_clicks_min": 0,
 "daily_clicks_max": 0,
 "bid": 999,
 "daily_cost_avg": 0,
 "daily_cost_min": 0,
 "daily_cost_max": 0,
 "time_update": "2021-03-28T14:05:34.4503662Z"
 },
 "bing_keyword_info": null,
 "extra": {
 "core_keyword": null
 }
 }
]

使用说明 ​

该页面描述的是数据库的数据结构，并非查询接口本身。使用时，通常需要通过数据库接口导出 JSON 或 CSV 数据，再按本文字段定义进行解析。

如果你的业务需要：

  • 按地区建立词库
  • 批量分析搜索趋势
  • 评估广告竞争与 CPC
  • 做分组与核心词聚类

可以直接基于上述字段完成数据建模。

认证示例 ​

调用本平台 API 时，认证头统一使用：

http
Authorization: Bearer smt_live_YOUR_KEY

参考接口示例 ​

虽然本页不是请求接口，但如需获取地区和语言支持列表，可使用如下方式。

cURL ​

bash
curl --request GET \
 --url "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 --header "Authorization: Bearer smt_live_YOUR_KEY"

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)

TypeScript ​

ts
const response = await fetch(
 "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages",
 {
 method: "GET",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY"
 }
 }
);

console.log(response.status);
console.log(await response.text);

注意事项 ​

  • 本页为历史版本说明，字段定义可用于容旧数据结构解析
  • keyword_info、impressions_info、bing_keyword_info、extra 在响应中可能为 null
  • categories 字段在部分记录中可能为空或为 null
  • history 为按月份组织的动态键值对象，解析时不应将月份字段写死
  • 广告金额字段原始单位通常为 USD，如需展示人民币，可按业务侧自行换算
  • 时间字段可能存在格式差异，建议统一按 ISO 8601 容处理

实用场景 ​

  • 构建行业词库：按国家、语言批量沉淀数据库，为 SEO 选题、规划和化站点搭建基础语料资产。
  • 评估商业价值：结合 search_volume、cpc、competition 判断是否流量潜力与变现能力，自然流量与广告投放协同决策。
  • 分析搜索趋势波动：利用 history 月度搜索数据识别季节性需求、热点回升和流量衰退，优化发布时间与资源节奏。
  • 识别核心词聚类：通过 extra.core_keyword 将近义词、变体词归并到核心主题，提升分组、专题页规划和站信息架构设计效率。
  • 广告预估：结合 impressions_info 中的展现、点击、成本区间数据，评估某类的投放强度和预算消耗，为竞价策略提供参考。

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

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