Google量统一搜索数据库

概述

Google量统一搜索数据库是两类数据的组合：

高级 Google SERP 数据库：覆盖 67 个地区，数百万条搜索结果页（SERP）数据，并支持大量高级 SERP 特性，如精选摘要、知识图谱、People Also Ask、Top Stories 等；
Google 数据库：覆盖数十亿搜索词，并附带搜索量趋势、CPC、竞争度等广告指标。

该数据库提供 JSON 格式。

示例数据下载：可下载美国地区、英文语言的 JSON 示例文件
地区/语言列表：可通过位置与语言接口获取，或使用官方提供的 CSV 列表

获取可用地区与语言代码，请调用：

/v3/dataforseo_labs/locations_and_languages

数据格式说明

数据库中的每条记录，表示一个在指定地区与语言下的指标和 SERP 数据集合。

顶层字段

字段	类型	说明
`keyword`	string	，使用 UTF-8 编码
`location`	integer	地区代码，唯一标识对应地区，例如 `2840` 表示美国
`language`	string	语言代码，例如 `en` 表示英文
`spell`	string	搜索引擎自动纠正后的；若原词被纠正，会返回纠正词及纠正类型
`spell_type`	string	自动纠正类型，可选值：`did_you_mean`、`showing_results_for`、`no_results_found_for`、`including_results_for`
`keyword_info`	object	当前的指标数据
`serp_info`	object	当前对应的 SERP 数据
`extra`	object	补信息
`search_intent_info`	object	搜索意图信息

获取地区与语言代码

可以通过以下接口获取支持的地区与语言及对应代码：

/v3/dataforseo_labs/locations_and_languages

示例基础地址：

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

`keyword_info` 字段说明

字段	类型	说明
`search_volume`	integer	平均月搜索量，表示在 google.com 上该的大致搜索次数
`cpc`	float	平均点击成本。该值基于广告顶部出价数据推算
`competition`	float	竞争度，取值范围 `0` 到 `1`
`competition_level`	string	付费搜索竞争等级：`LOW`、`MEDIUM`、`HIGH`；未知时为 `null`
`low_top_of_page_bid`	float	首页顶部最低出价参考值，约高于最低出价的 20%
`high_top_of_page_bid`	float	首页顶部较高出价参考值，约高于最低出价的 80%
`time_update`	string	数据最后更新时间，ISO 8601 格式，如 `2020-09-12T00:07:43.0733218Z`
`categories`	array	产品与服务分类
`history`	object	历史月搜索量，通常可追溯过去 4 年

`history` 示例

json

{
 "202203": 210,
 "202204": 170,
 "202205": 210
}

`serp_info` 字段说明

字段	类型	说明
`check_url`	string	直达搜索结果页的链接，用于核对结果
`items_count`	integer	`serp` 数组中返回的数量
`keyword_difficulty`	integer	排名难度，范围 `0-100`，表示自然结果前 10 的难度
`se_results_count`	integer	SERP 总结果数
`time_update`	string	SERP 数据最新更新时间，ISO 8601 格式
`previous_updated_time`	string	上一次 SERP 更新时间，ISO 8601 格式
`item_types`	array	本次 SERP 中出现的结果类型列表
`serp`	array	该采集到的 SERP素数据

`item_types` 可选值

answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, google_posts, google_hotels, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, math_solver, currency_box, product_considerations, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, third_party_reviews, ai_overview

SERP 通用字段

大多数 serp素都以下通用字段：

字段	类型	说明
`type`	string	素类型
`position`	string	素在页面中的侧边位置，可为 `left`、`right`
`xpath`	string	素的 XPath
`traffic_cost`	float	预估将同等自然流量转化为付费流量所需成本，或按 `etv × cpc` 推算的流量价值
`rank_group`	integer	同类型组排名
`rank_absolute`	integer	SERP局绝对排名
`etv`	float	预估自然流量

主要 SERP素结构

由于支持的 SERP 类型非常多，以下保留最核心、最常用的结构说明。余类型遵循相同模式：类型标识、字段以及通用排名字段。

1. `organic` 自然结果

字段	类型	说明
`title`	string	标题
`pre_snippet`	string	描述前附加信息
`description`	string	描述文本
`breadcrumb`	string	面屑
`images`	array	图片列表
`is_image`	boolean	是否图片
`is_video`	boolean	是否视频
`is_featured_snippet`	boolean	是否为精选摘要来源
`extended_snippet`	string	描述后附加信息
`amp_version`	boolean	是否有 AMP 版本
`rating`	object	评分信息
`highlighted`	array	描述中加粗词
`links`	array	站点链接
`domain`	string	完整域名
`main_domain`	string	主域名，不含子域
`url`	string	结果绝对 URL
`relative_url`	string	相对 URL
`is_malicious`	boolean	是否被标记为恶意
`faq`	object	FAQ 扩展信息
`is_new`	boolean	相比上次数据库版本是否为新结果
`is_up`	boolean	相比上次是否上升
`is_down`	boolean	相比上次是否下降
`previous_rank_absolute`	integer	上次绝对排名
`extended_people_also_search`	array	扩展搜索
`cache_url`	string	页面缓存链接
`price`	object	价格信息
`related_search_url`	string	相似搜索链接
`related_result`	array	同域结果
`about_this_result`	object	“此结果”面板信息
`is_web_story`	boolean	是否为 Web Story
`timestamp`	string	发布时间，UTC 格式
`rank_info`	object	页面与主域的排名信息

`rating` 对象

字段	类型	说明
`rating_type`	string	评分类型：`Max5`、`Percents`、`CustomMax`
`value`	integer/float	评分值
`votes_count`	integer	评价数
`rating_max`	integer	最大评分值

`about_this_result` 对象

字段	类型	说明
`type`	string	固定为 `about_this_result_element`
`url`	string	结果 URL
`source`	string	附加信息来源
`source_info`	string	来源说明或站点背景信息
`source_url`	string	来源链接
`language`	string	结果语言
`location`	string	结果适用地区
`search_terms`	array	匹搜索词
`related_terms`	array	搜索词

`rank_info` 对象

字段	类型	说明
`page_rank`	integer	页面等级分
`main_domain_rank`	integer	主域等级分

2. `paid` 付费结果

字段	类型	说明
`title`	string	广告标题
`domain`	string	广告域名
`description`	string	广告描述
`breadcrumb`	string	广告面屑
`url`	string	广告目标 URL
`main_domain`	string	主域名
`relative_url`	string	相对链接
`highlighted`	array	加粗词
`extra.ad_aclk`	string	广告标识符
`description_rows`	array	扩展描述
`links`	array	广告附加链接
`is_new`	boolean	是否为新广告结果
`is_up`	boolean	是否排名上升
`is_down`	boolean	是否排名下降
`previous_rank_absolute`	integer	上次绝对排名
`price`	object	商品/服务价格
`rank_info`	object	页面与域名排名信息

3. `featured_snippet` 精选摘要

字段	类型	说明
`title`	string	摘要标题
`featured_title`	string	来源页面标题
`description`	string	摘要文本
`table`	object	表格型摘要
`domain`	string	域名
`main_domain`	string	主域名
`url`	string	结果 URL
`relative_url`	string	相对 URL
`images`	array	图片
`timestamp`	string	发布时间
`rank_info`	object	页面/域名排名信息

4. `people_also_ask` 人还问

字段	类型	说明
`items`	array	问答项列表
`type`	string	固定为 `people_also_ask`

`people_also_ask_element`

字段	类型	说明
`title`	string	问题标题
`seed_question`	string	触发扩展的问题
`xpath`	string	问题 XPath
`expanded_element`	array	展开后的答案

5. `knowledge_graph` 知识图谱

字段	类型	说明
`title`	string	实体名称
`subtitle`	string	副标题
`description`	string	描述
`card_id`	string	卡片 ID
`url`	string	网址
`logo_url`	string	Logo 图片 URL
`items`	array	知识图谱子

知识图谱可能以下子类型：

knowledge_graph_carousel_item
knowledge_graph_description_item
knowledge_graph_images_item
knowledge_graph_list_item
knowledge_graph_row_item
knowledge_graph_part_item
knowledge_graph_shopping_item
knowledge_graph_expanded_item
knowledge_graph_ai_overview_item

6. `ai_overview` AI 概览

字段	类型	说明
`type`	string	固定为 `ai_overview`
`asynchronous_ai_overview`	boolean	是否异步加载
`markdown`	string	Markdown 格式
`items`	array	AI 概览项
`references`	array	引用来源
`position`	string	页面位置
`traffic_cost`	float	流量价值
`rank_group`	integer	分组排名
`rank_absolute`	integer	绝对排名
`etv`	float	预估流量

`ai_overview_element`

字段	类型	说明
`title`	string	标题
`text`	string	文本
`markdown`	string	Markdown
`links`	array	链接
`images`	array	图片
`references`	array	参考来源

`ai_overview_reference`

字段	类型	说明
`source`	string	来源名称
`domain`	string	来源域名
`url`	string	来源页面
`title`	string	来源标题
`text`	string	被引用文本片段

7. 常见 SERP 类型

以下类型也会在数据库中返回，并采用同样的结构化方式：

carousel
multi_carousel
answer_box
related_searches
people_also_search
local_pack
top_stories
twitter
map
google_flights
google_reviews
video
images
shopping
jobs
events
mention_carousel
find_results_on
stocks_box
currency_box
recipes
top_sights
scholarly_articles
popular_products
podcasts
questions_and_answers
hotels_pack
google_posts
visual_stories
commercial_units
local_services
google_hotels
math_solver
app
product_considerations
short_videos
refine_products
explore_brands
perspectives
discussions_and_forums
compare_sites
third_party_reviews
courses

`extra` 字段说明

字段	类型	说明
`core_keyword`	string	分组中的核心词；若无匹则为 `null`
`synonym_clustering_algorithm`	string	同义词识别算法：`keyword_metrics` 或 `text_processing`
`detected_language`	string	系统识别出的语言
`keyword_difficulty`	integer	难度，范围 `0-100`

`search_intent_info` 字段说明

字段	类型	说明
`main_intent`	string	主要搜索意图：`informational`、`navigational`、`commercial`、`transactional`
`foreign_intent`	array	补搜索意图，取值同上
`last_updated_time`	string	搜索意图数据更新时间，ISO 8601 格式

计费说明

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

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

认证说明

调用本平台接口时，请使用 Bearer Token：

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.json)

TypeScript

typescript

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

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

JSON 记录示例

下面是该数据库单条记录的结构化示例。原始示例极长，这里保留字段结构，便于理解。

json

{
 "keyword": "no deposit cash bonus",
 "location": 2840,
 "language": "en",
 "spell": null,
 "spell_type": null,
 "keyword_info": {
 "search_volume": 90,
 "cpc": 8.948175,
 "competition": 1,
 "competition_level": "HIGH",
 "low_top_of_page_bid": null,
 "high_top_of_page_bid": null,
 "time_update": "2020-09-12T00:07:43.0733218Z",
 "categories": [],
 "history": {
 "202203": 210,
 "202204": 170,
 "202205": 210
 }
 },
 "serp_info": {
 "check_url": "https://www.google.com/search?q=example",
 "items_count": 84,
 "keyword_difficulty": 67,
 "se_results_count": 73,
 "time_update": "2022-04-03T14:23:56.6678836Z",
 "previous_updated_time": "2022-02-05T21:18:02.7517072Z",
 "item_types": [
 "organic",
 "featured_snippet",
 "people_also_ask",
 "ai_overview"
 ],
 "serp": [
 {
 "type": "organic",
 "title": "How to pronounce TENTATIVELY in English",
 "description": "How to pronounce tentatively...",
 "domain": "dictionary.cambridge.org",
 "main_domain": "cambridge.org",
 "url": "https://dictionary.cambridge.org/us/pronunciation/english/tentatively",
 "is_new": false,
 "is_up": true,
 "is_down": false,
 "previous_rank_absolute": 5,
 "position": "left",
 "xpath": "/html/body/div/div/div/div/div/div/div/div/div",
 "traffic_cost": 0,
 "rank_group": 1,
 "rank_absolute": 4,
 "etv": 33.44
 },
 {
 "type": "featured_snippet",
 "title": "BRS Deluxe Carbon & GFO Reactor",
 "domain": "www.youtube.com",
 "main_domain": "youtube.com",
 "url": "https://www.youtube.com/watch?v=RNEZ8H_DLgQ",
 "position": "left",
 "xpath": "/html/body/div/div/div/div/div/div/div/div/div/block-component/div/div/div/div/div",
 "traffic_cost": 0,
 "rank_group": 1,
 "rank_absolute": 1,
 "etv": 6.08
 },
 {
 "type": "ai_overview",
 "asynchronous_ai_overview": false,
 "items": [
 {
 "type": "ai_overview_element",
 "title": "Common Causes:",
 "text": "Ingrown hairs, irritation, folliculitis..."
 }
 ],
 "position": "left",
 "xpath": "/html/body/div/div/div/div/div/div/div/div/div/div/div",
 "traffic_cost": 14.591999999999999,
 "rank_group": 1,
 "rank_absolute": 1,
 "etv": 145.92
 }
 ]
 },
 "extra": {
 "core_keyword": null,
 "detected_language": "en",
 "keyword_difficulty": 22
 },
 "search_intent_info": {
 "main_intent": "navigational",
 "foreign_intent": [],
 "last_updated_time": "2023-03-03T08:19:40.9387576Z"
 }
}

注意事项

数据库为离线 JSON 数据文件，不是单条查询接口返回格式。
同一个会同时附带：

维度指标；
SERP 结构化结果；
搜索意图与补属性。

不同 type 的 SERP素字段差异很大，接时建议按 type 分发解析。
时间字段通常采用：

ISO 8601；
或 UTC 时间字符串格式 yyyy-mm-dd hh-mm-ss +00:00。

某些价格、汇率、股票等数据依赖搜索结果展示时点，时效性。

实用场景

构建景库：将搜索量、CPC、竞争度、SERP 特性统一库，支撑 SEO 选词、聚类与机会识别。
识别 SERP 版位机会：分析 item_types 与 serp 结构，判断某类更容易触发精选摘要、PAA、视频或本地，从而优化策略。
评估自然流量商业价值：结合 etv、traffic_cost、keyword_difficulty，判断获取自然流量的产出比。
监控结果页结构变化：基于 is_new、is_up、is_down、previous_rank_absolute 跟踪排名与 SERP 组件变化，发现竞争格局波动。
分析搜索意图与匹度：利用 search_intent_info、about_this_result、ai_overview 等字段，优化落地页类型与形式，提高覆盖率与转化率。

Google量统一搜索数据库 ​

概述 ​

数据格式说明 ​

顶层字段 ​

获取地区与语言代码 ​

keyword_info 字段说明 ​

history 示例 ​

serp_info 字段说明 ​

item_types 可选值 ​

SERP 通用字段 ​

主要 SERP素结构 ​

1. organic 自然结果 ​

rating 对象 ​

about_this_result 对象 ​

rank_info 对象 ​

2. paid 付费结果 ​

3. featured_snippet 精选摘要 ​

4. people_also_ask 人还问 ​

people_also_ask_element ​

5. knowledge_graph 知识图谱 ​

6. ai_overview AI 概览 ​

ai_overview_element ​

ai_overview_reference ​

7. 常见 SERP 类型 ​

extra 字段说明 ​

search_intent_info 字段说明 ​

计费说明 ​

认证说明 ​

示例：获取地区与语言支持列表 ​

cURL ​

Python ​

TypeScript ​