Google 数据库

概述

Google 数据库收录了数十亿级搜索词，并附带搜索量趋势及 Google Ads 数据。

数据来自多个来源 Google Ads 与 Google 搜索结果页。本平台会持续向数据库补新，并通常在每月后半段逐步更新指标数据（受 Google Ads 更新周期影响）。

该数据库支持以下两种格式：

• JSON
• CSV

可下载美国地区、英语语言的数据库示例文件作为参考文档中的样例数据。

如需获取支持的地区与语言列表，可通过接口查询：

/v3/dataforseo_labs/locations_and_languages

计费说明

该数据库的费用取决于的数据规模以及地区参数。

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

字段说明

顶层字段

字段名	类型	说明
keyword	string	，采用 UTF-8 编码
location	integer	地区代码，对应唯一地区标识。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用 location_code 列表。例如：2840 表示 United States
language	string	语言代码，对应指定地区可用语言。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用 language_code 列表。例如：en 表示 English
spell	string	搜索引擎自动纠正后的。如果搜索引擎对原做了纠错并返回结果，这里会返回纠正后的词及纠错类型
spell_type	string	自动纠错类型。可选值：did_you_mean、showing_results_for、no_results_found_for
keyword_info	object	返回的核心指标数据
extra	object	的附加信息
search_intent_info	object	返回的搜索意图信息

---

keyword_info 字段

字段名	类型	说明
search_volume	integer	平均月搜索量。表示指定在 google.com 或 google.com 及合作网络上的近似搜索次数，取决于目标定向设置
cpc	float	平均点击成本（USD）。表示该历史平均 CPC。需要注意：Google Ads 不单独提供 CPC 数据，因此该字段基于 high_top_of_page_bid 推算
competition	float	竞争度，取值范围为 0 到 1（含边界），基于 Google Ads 数据计算
competition_level	string	付费搜索结果中的竞争等级。可选值：LOW、MEDIUM、HIGH。若未知则为 null
low_top_of_page_bid	float	广告出现在首页顶部位置的较低出价参考值。通常表示高于约 20% 最低展示出价的水平，基于 Google Ads 广告主统计数据
high_top_of_page_bid	float	广告出现在首页顶部位置的较高出价参考值。通常表示高于约 80% 最低展示出价的水平，基于 Google Ads 广告主统计数据
time_update	string	数据最近更新时间，采用 ISO 8601 格式：YYYY-MM-DDThh:mm:ss.sssssssZ。示例：2020-09-12T00:07:43.0733218Z
categories	array	产品与服务分类
history	object	月度搜索量历史。表示该在指定地区的近似月搜索量，历史数据可回溯过去 4 年

---

extra 字段

字段名	类型	说明
core_keyword	string	分组中的核心词。该分组基于 keyword_info 各项指标的相似性构建。若为 null，表示数据库中没有满足条件的相似组
synonym_clustering_algorithm	string	用于识别同义词的算法。可选值：keyword_metrics（基于 keyword_info 指标）、text_processing（基于文本处理）。若为 null，表示数据库中没有识别为该同义词的结果
detected_language	string	系统识别出的语言
keyword_difficulty	integer	难度，范围 0 到 100。用于衡量自然搜索前 10 结果的难度。该值基于对 SERP 前 10 页面链接画像等多种因素的分析计算得出

---

search_intent_info 字段

字段名	类型	说明
main_intent	string	主要搜索意图。可选值：informational、navigational、commercial、transactional
foreign_intent	array	补搜索意图。可选值：informational、navigational、commercial、transactional
last_updated_time	string	搜索意图数据最近更新时间，采用 ISO 8601 格式：YYYY-MM-DDThh:mm:ss.sssssssZ。示例：2022-09-12T00:07:43.0733218Z

数据结构示例

JSON 格式数据库中的单条记录结构如下：

{
 "keyword": "races day",
 "location": 2036,
 "language": "en",
 "spell": null,
 "spell_type": null,
 "keyword_info": {
 "search_volume": 260,
 "cpc": null,
 "competition": 0.01,
 "competition_level": "LOW",
 "low_top_of_page_bid": null,
 "high_top_of_page_bid": null,
 "time_update": "2023-03-21T20:25:36.3263513Z",
 "categories": [],
 "history": {
 "202203": 210,
 "202204": 170,
 "202205": 210,
 "202206": 170,
 "202207": 260,
 "202208": 320,
 "202209": 320,
 "202210": 720,
 "202211": 260,
 "202212": 260,
 "202301": 170,
 "202302": 170
 }
 },
 "extra": {
 "core_keyword": null,
 "detected_language": "en",
 "keyword_difficulty": 57
 },
 "search_intent_info": {
 "main_intent": "informational",
 "foreign_intent": [],
 "last_updated_time": "2023-03-02T17:23:41.2125531Z"
 }
}

获取地区与语言列表

如需确认数据库支持的地区代码与语言代码，可调用以下接口：

请求地址

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

认证方式

Authorization: Bearer smt_live_YOUR_KEY

curl 示例

curl -X POST "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 -H "Authorization: Bearer smt_live_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '[{}]'

Python 示例

import requests

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

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

TypeScript 示例

const response = await fetch("https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages", {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify([{}])
});

const data = await response.json;
console.log(data);

使用说明

• 该页面描述的是离线数据库的数据结构与字段含义。
• 数据库可按地区、语言等维度进行筛选或下载，适用于大规模研究。
• history 字段可用于分析季节性趋势、周期性变化及历史需求波动。
• search_intent_info 可判断在营销、品牌导航和商业转化中的适用场景。
• keyword_difficulty 可用于评估自然搜索竞争强度，帮助制定与外链策略。

注意事项

• 数据为近似值，数值可能随平台数据源更新而变化。
• cpc、competition、top_of_page_bid 等字段基于广告数据，主要适用于投放与商业价值评估。
• 某些字段可能返回 null，这通常表示当前数据库中暂无可用值，而非请求异常。
• 指标通常在每月后半段逐步更新。
• 历史搜索量数据最长支持近 4 年。

实用场景

• 挖掘高潜力：结合 search_volume、keyword_difficulty 和 search_intent_info，筛选流量空间与可排名性的选题。
• 评估商业投放价值：基于 cpc、competition、low_top_of_page_bid、high_top_of_page_bid 判断的广告竞争程度和转化价值。
• 分析季节性需求波动：利用 history 月度搜索量数据识别旺季、淡季与热点周期，优化发布时间和预算分。
• 构建聚类体系：通过 core_keyword、同义词识别逻辑及指标相似性，将海量词库整理为可执行的专题分组。
• 优化多地区多语言 SEO：结合 location、language、detected_language 规划本地化策略，提升不同市场的搜索覆盖率。