Google 历史 SERP 高级数据库

概述

Google 历史 SERP 高级数据库提供按月沉淀的海量 Google 搜索结果快，数据采用 JSON 结构化存储，丰富的 SERP 特性与结果，例如精选摘要、知识图谱、People Also Ask、Top Stories、AI Overview 等。

除常规指标外，本数据库还提供：

• 指定在不同月份的历史搜索量与广告竞价指标
• 每次 SERP 快中的结果及结构化字段
• 自然结果对应的页面权重与主域名权重
• 结果排名变动信息，例如是否新出现、是否上升/下降、上一次排名位置等

数据范围与格式

• 历史可用范围：最近 365 天
• 数据格式：支持 JSON
• 数据：按、地区、语言维度组织，按月提供历史数据与 SERP 快

如需获取支持的地区与语言列表，可调用：

/v3/dataforseo_labs/locations_and_languages

计费说明

该数据库的费用与数据规模、地区参数等因素。

• 扣费以响应头 X-SeerMarTech-Charge-CNY 为准
• 如平台返回单次或单文件费用，可按以下方式换算参考人民币价格： 参考价约 ¥金额 / 次

本页原始说明未提供固定单价，因此无法给出统一人民币参考价。

数据结构说明

数据库中的顶层对象通常以下核心部分：

• keyword：
• location：地区代码
• language：语言代码
• spell / spell_type：搜索引擎自动纠错结果
• keyword_info_history：历史指标
• serp_info_history：历史 SERP 快
• extra：附加信息
• search_intent_info：搜索意图信息

---

顶层字段说明

字段	类型	说明
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_history	object	返回的历史指标
serp_info_history	object	返回可用的历史 SERP 数据
extra	object	附加信息
search_intent_info	object	返回的搜索意图信息

---

keyword_info_history 字段说明

keyword_info_history 按月份组织，每个键为 YYYYMM 格式，例如 "202109"。

月度指标字段

字段	类型	说明
$date	object	月份变量，格式为 YYYYMM
search_volume	integer	平均月搜索量
cpc	float	历史平均点击成本，单位 USD；该值通常基于广告顶部高位出价推算
competition	float	广告竞争度，范围 0 到 1
competition_level	string	付费搜索竞争等级，可选值：LOW、MEDIUM、HIGH，未知时为 null
low_top_of_page_bid	float	首页顶部广告最低竞价参考值
high_top_of_page_bid	float	首页顶部广告高位竞价参考值
time_update	string	数据最近更新时间，ISO 8601 格式
categories	array	产品与服务分类
history	object	最近 12 个月月度搜索量，例如 "202109": 40

说明

• search_volume 表示目标地区与语言下的近似平均月搜索量。
• cpc 单位为，若需人民币估算，可自行参考响应头中的扣费金额。
• history 提供近 12 个月搜索量时间序列，适合做季节性分析与需求趋势判断。

---

serp_info_history 字段说明

serp_info_history 为历史 SERP 快集合，每个月通常对应一个 SERP 对象。

SERP 快通用字段

字段	类型	说明
check_url	string	对应搜索结果页直达链接，可用于人工校验
items_count	integer	serp 数组中的结果数量
keyword_difficulty	integer	难度，范围 0-100
se_results_count	integer	SERP 总结果数
time_update	string	当前 SERP 快更新时间，ISO 8601 格式
previous_updated_time	string	上一次 SERP 更新的时间
item_types	array	当前 SERP 中的结果类型列表
serp	array	SERP素数组

item_types 可能值

item_types 可能以下类型：

• answer_box
• 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
• third_party_reviews
• ai_overview

---

serp 数组通用字段

不同类型的 SERP素不同字段，但多数以下通用属性：

字段	类型	说明
type	string	素类型
position	string	页面布局位置，可为 left 或 right
xpath	string	素的 XPath
rank_group	integer	同类型结果中的组排名
rank_absolute	integer	在整页 SERP 中的绝对排名
traffic_cost	float	估算流量成本
etv	float	预估自然流量
is_new	boolean	是否为相较上一版新增结果
is_up	boolean	是否较上一版上升
is_down	boolean	是否较上一版下降
previous_rank_absolute	integer	上一次的绝对排名

---

常见 SERP素字段说明

由于该数据库支持的 SERP 类型非常多，以下按使用频率列出重点结构。余类型仍遵循原始字段命名，且会出现在返回 JSON 中。

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 扩展
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	页面与主域权重信息

organic.rank_info

字段	类型	说明
page_rank	integer	页面权重
main_domain_rank	integer	主域名权重

organic.rating

字段	类型	说明
rating_type	string	评分类型，可能为 Max5、Percents、CustomMax
value	integer/float	评分值
votes_count	integer	评价数量
rating_max	integer	评分上限

organic.links

字段	类型	说明
type	string	固定为 link_element
title	string	链接标题
description	string	链接说明
url	string	链接地址

organic.faq

字段	类型	说明
type	string	固定为 faq_box
items	array	FAQ 条目数组

---

2) paid 付费结果

字段	类型	说明
title	string	广告标题
domain	string	广告域名
description	string	广告描述
breadcrumb	string	面屑
url	string	广告目标 URL
main_domain	string	主域名
relative_url	string	相对 URL
highlighted	array	加粗词
extra	object	附加广告信息
description_rows	array	扩展描述
links	array	广告站点链接
price	object	价格信息
rank_info	object	页面与域名权重信息

paid.extra

字段	类型	说明
ad_aclk	string	广告标识符

---

3) featured_snippet 精选摘要

字段	类型	说明
title	string	精选摘要标题
featured_title	string	来源页面标题
description	string	摘要文本
table	object	表格型摘要
domain	string	域名
main_domain	string	主域名
url	string	来源链接
relative_url	string	相对链接
images	array	图片数组
timestamp	string	发布时间
rank_info	object	页面与主域权重

---

4) people_also_ask 人还问

字段	类型	说明
items	array	问题项数组
type	string	固定为 people_also_ask

people_also_ask.items[]

字段	类型	说明
type	string	固定为 people_also_ask_element
title	string	问题标题
seed_question	string	触发扩展问题的种子问题
xpath	string	素 XPath
expanded_element	array	展开后

expanded_element 可能：

• 普通网页摘要
• 表格
• 图片
• AI Overview 扩展
• 视频型 AI
• 表格型 AI
• 多段组件式 AI

---

5) knowledge_graph 知识图谱

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

知识图谱子可能：

• knowledge_graph_description_item
• knowledge_graph_images_item
• knowledge_graph_list_item
• knowledge_graph_row_item
• knowledge_graph_part_item
• knowledge_graph_carousel_item
• knowledge_graph_shopping_item
• knowledge_graph_expanded_item
• knowledge_graph_ai_overview_item

这些子通常用于承载描述、图片集合、列表模块、属性行、扩展块、购物信息和 AI 总结。

---

6) ai_overview AI 总览

字段	类型	说明
type	string	固定为 ai_overview
asynchronous_ai_overview	boolean	是否异步加载
markdown	string	AI 总览的 Markdown 文本
items	array	AI条目
references	array	引用来源
position	string	位置
xpath	string	XPath
rank_group	integer	组排名
rank_absolute	integer	绝对排名
traffic_cost	float	估算流量成本
etv	float	预估流量

ai_overview.items[] 可能类型

• ai_overview_element
• ai_overview_video_element
• ai_overview_table_element
• ai_overview_expanded_element

ai_overview_reference

字段	类型	说明
type	string	固定为 ai_overview_reference
source	string	引用来源名
domain	string	引用域名
url	string	引用页面链接
title	string	引用页面标题
text	string	被引用文本片段

---

7) 高频 SERP 类型

以下类型在历史数据库中也较常见，字段结构均保留在 JSON 中：

• 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
• 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
• product_considerations
• short_videos
• refine_products
• explore_brands
• perspectives
• discussions_and_forums
• compare_sites
• third_party_reviews

---

extra 字段说明

| 字段 | 类型 | 说明

实用场景

• 待补充具体业务场景