Google 历史 SERP 高级数据库

GET /v3/dataforseo_labs/locations_and_languages

概述

Google 历史 SERP 高级数据库数百万条按月保存的 Google 搜索结果页快。数据以 JSON 格式提供，并保留搜索结果中的多种 SERP 特征精选摘要、知识图谱、“人还问”、热门、图片、视频、购物结果、本地服务和 AI Overview 等。

除指标和 SERP素结构化数据外，数据库还为自然搜索结果提供页面排名和主域名排名信息。历史数据最长可追溯至最近 365 天。

本数据库提供 JSON 格式。

> 数据库为文件型数据集，不对应单独的 POST API 任务创建接口。下载或接数据库时，请以当前控制台提供的文件地址和权限为准。

数据文件

示例数据：美国地区、英语语言的 JSON 数据库样例。
支持的地区和语言：可通过以下接口获取地区代码和语言代码：
GET https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages

示例：

location: 2840：美国
language: en：英语

计费

数据库费用取决于数据集的大小和地区参数。

参考价：根据数据集规格计算。
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

数据结构

数据库中的每条记录通常以下顶层字段：

字段	类型	说明
`keyword`	string	，使用 UTF-8 编码
`location`	integer	地区代码
`language`	string	语言代码
`spell`	string	搜索引擎自动修正后的；未修正时为 `null`
`spell_type`	string	自动修正类型
`keyword_info_history`	object	历史指标，键名为 `YYYYMM`
`serp_info_history`	object	历史 SERP 数据，键名通常为月份
`extra`	object	附加信息
`search_intent_info`	object	搜索意图信息

`spell_type` 可选值

did_you_mean
showing_results_for
no_results_found_for
including_results_for

历史指标

keyword_info_history 是一个对象键名为 YYYYMM，例如 202109。每个月份对象以下字段：

字段	类型	说明
`search_volume`	integer	平均月搜索量
`cpc`	float	历史平均每次点击费用，单位为原始数据值
`competition`	float	付费搜索竞争度，取值范围为 `0` 至 `1`
`competition_level`	string	付费 SERP 竞争等级，可取 `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 个月的月搜索量，键名为 `YYYYMM`

cpc 字段基于广告数据中的首页顶部出价估算。由于广告平台通常不会直接提供独立的 CPC 历史数据，该字段应视为估算指标。

示例：

json

{
  "202109": {
    "search_volume": 1300,
    "cpc": 0.422711,
    "competition": 1,
    "competition_level": null,
    "low_top_of_page_bid": null,
    "high_top_of_page_bid": null,
    "time_update": "2021-10-12T18:29:11.9262890Z",
    "categories": [],
    "history": {
      "202010": 1000,
      "202011": 720,
      "202012": 720,
      "202101": 590,
      "202102": 720,
      "202103": 1000,
      "202104": 1600,
      "202105": 2400,
      "202106": 2900,
      "202107": 2400,
      "202108": 1900,
      "202109": 1000
    }
  }
}

历史 SERP 数据

serp_info_history 保存指定在不同月份的搜索结果页快。每个月份对象可以下字段：

字段	类型	说明
`check_url`	string	对应搜索结果页的直接 URL，可用于核验结果
`items_count`	integer	`serp` 数组中的结果数量
`keyword_difficulty`	integer	排名难度，取值范围为 `0` 至 `100`
`se_results_count`	integer	搜索结果总数量
`time_update`	string	当前 SERP 数据更新时间，ISO 8601 格式
`previous_updated_time`	string	上一次 SERP 数据更新时间
`item_types`	array	当前 SERP 中出现的结果类型
`serp`	array	当前快中的 SERP素

`keyword_difficulty`

排名难度表示前 10 个自然搜索结果的难度，采用 0 至 100 的对数刻度。该指标会综合分析 SERP 前 10 个页面的链接特征等因素。

`item_types` 可选值

item_types 用于列出当前快中出现的 SERP素类型，可能：

text

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	SERP素类型
`position`	string	素在 SERP 中的对齐位置，可取 `left`、`right`
`xpath`	string	素在页面中的 XPath
`traffic_cost`	float	估算的月度搜索流量付费价值
`rank_group`	integer	同类型中的组排名
`rank_absolute`	integer	在 SERP素中的绝对排名
`etv`	float	估算月自然流量
`is_new`	boolean	与上一版本相比是否为新增
`is_up`	boolean	与上一版本相比排名是否上升
`is_down`	boolean	与上一版本相比排名是否下降
`previous_rank_absolute`	integer	上一版本中的绝对排名
`rank_info`	object	页面排名和主域名排名
`page_rank`	integer	页面排名
`main_domain_rank`	integer	主域名排名

rank_group 在相同 type 的之间计算；不同类型之间不会参与该字段的排名。

traffic_cost 通常根据自然搜索估算流量 etv 与付费点击价格 cpc 计算，用于估算通过付费搜索获取同等流量所需的月度成本。

自然结果 `organic`

自然结果通常以下字段：

字段	类型	说明
`title`	string	搜索结果标题
`pre_snippet`	string	描述前附加信息
`description`	string	结果描述
`breadcrumb`	string	面屑路径
`url`	string	绝对 URL
`relative_url`	string	相对 URL
`domain`	string	结果域名
`main_domain`	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	站点链接；没有时为 `null`
`faq`	object	FAQ 扩展；没有时为 `null`
`is_malicious`	boolean	是否被标记为恶意结果
`cache_url`	string	页面缓存地址
`price`	object	产品或服务价格信息
`related_search_url`	string	搜索 URL
`related_result`	array	来自同一域名的结果
`about_this_result`	object	“此结果”面板信息
`is_web_story`	boolean	是否为网页
`timestamp`	string	结果发布时间
`extended_people_also_search`	array	搜索词扩展
`type`	string	固定为 `organic`

`images`

字段	类型	说明
`type`	string	固定为 `images_element`
`alt`	string	图片替代文本
`url`	string	图片页面 URL
`image_url`	string	图片 URL
`is_image`	boolean	是否图片
`is_video`	boolean	是否视频

`rating`

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

`links`

站点链接数组中的通常：

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

`faq`

字段	类型	说明
`type`	string	固定为 `faq_box`
`items`	array	FAQ 项目
`items[].type`	string	固定为 `faq_box_element`
`items[].title`	string	问题
`items[].description`	string	展开后的答案
`items[].links`	array	FAQ 项目中的链接

`about_this_result`

字段	类型	说明
`type`	string	固定为 `about_this_result_element`
`url`	string	结果 URL
`source`	string	附加信息来源
`source_info`	string	来源说明
`source_url`	string	来源详细页面 URL
`language`	string	结果语言
`location`	string	结果适用地区
`search_terms`	array	结果中匹的搜索词
`related_terms`	array	结果中出现的词

付费结果 `paid`

付费结果通常：

字段	类型	说明
`title`	string	广告标题
`domain`	string	广告结果完整域名
`description`	string	广告描述
`breadcrumb`	string	广告面屑
`url`	string	广告目标绝对 URL
`main_domain`	string	主域名
`relative_url`	string	相对 URL
`highlighted`	array	描述中高亮词语
`extra`	object	广告附加信息
`extra.ad_aclk`	string	广告标识符
`description_rows`	array	扩展描述，没有时为 `null`
`links`	array	广告站点链接
`price`	object	产品或服务价格
`rank_info`	object	页面和主域名排名
`type`	string	固定为 `paid`

广告站点链接中的类型为 ad_link_element，通常 title、url、description 和 ad_aclk。

常见 SERP 特征字段

`carousel` 与 `multi_carousel`

carousel 通常：

title：轮播模块标题
items：轮播项目
items[].type：固定为 carousel_element
items[].title：项目标题
items[].subtitle：项目副标题

multi_carousel 通常：

items
items[].type：multi_carousel_element
items[].multi_carousel_snippets
multi_carousel_snippets[].type：multi_carousel_snippet
multi_carousel_snippets[].title：项目标题

`answer_box`

字段	类型	说明
`text`	array	答案文本
`links`	array	链接
`type`	string	固定为 `answer_box`
`position`	string	`left` 或 `right`
`xpath`	string	XPath
`traffic_cost`	float	估算流量价值
`rank_group`	integer	组排名
`rank_absolute`	integer	绝对排名
`etv`	float	估算流量

`featured_snippet`

字段	类型	说明
`title`	string	搜索结果标题
`featured_title`	string	来源页面标题
`description`	string	摘要描述
`table`	object	摘要中的表格
`table.table_header`	array	表头
`table.table_content`	array	表格
`domain`	string	域名
`main_domain`	string	主域名
`url`	string	结果 URL
`relative_url`	string	相对 URL
`images`	array	图片
`timestamp`	string	发布时间
`rank_info`	object	页面和域名排名
`type`	string	固定为 `featured_snippet`

`people_also_ask`

字段	类型	说明
`items`	array	“人还问”项目
`items[].type`	string	固定为 `people_also_ask_element`
`items[].title`	string	问题标题
`items[].seed_question`	string	触发展开结果的种子问题
`items[].expanded_element`	array	展开后的结果
`expanded_element[].featured_title`	string	来源页面标题
`expanded_element[].url`	string	来源 URL
`expanded_element[].domain`	string	来源域名
`expanded_element[].description`	string	描述
`expanded_element[].images`	array	图片
`expanded_element[].table`	object	表格
`expanded_element[].timestamp`	string	发布时间

`related_searches` 与 `people_also_search`

这两类通常：

items：搜索项目
items[].title：搜索标题
type：分别为 related_searches 或 people_also_search
position
xpath
traffic_cost
rank_group
rank_absolute
etv

`local_pack`

本地结果通常：

字段	类型	说明
`title`	string	商户或地点名称
`description`	string	商户描述
`phone`	string	电话
`booking_url`	string	预约地址
`is_paid`	boolean	是否为广告
`rating`	object	评分
`domain`	string	域名
`main_domain`	string	主域名
`url`	string	商户 URL
`relative_url`	string	相对 URL
`type`	string	固定为 `local_pack`
`rank_info`	object	页面和域名排名

`knowledge_graph`

知识图谱可：

字段	类型	说明
`title`	string	知识图谱标题
`subtitle`	string	副标题
`description`	string	描述
`card_id`	string	卡片标识
`url`	string	URL
`logo_url`	string	标志图片 URL
`items`	array	知识图谱子
`type`	string	固定为 `knowledge_graph`

子类型：

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_expanded_item
knowledge_graph_shopping_item
knowledge_graph_ai_overview_item

常见子字段：

title
subtitle
text
url
domain
image_url
data_attrid
link
links
items
expanded_element
table

：

data_attrid 为搜索引擎定义的数据属性标识，例如 action:listen_artist。
link.type 通常为 link_element。
knowledge_graph_expanded_element 可 featured_title、table、table_header 和 table_content。
knowledge_graph_shopping_item 可商品价格、来源、卖家和商城链接。

图片、购物和商品结果

`images`

字段	类型	说明
`title`	string	图片模块标题
`url`	string	图片搜索 URL
`items`	array	图片项目
`related_image_searches`	array	图片搜索
`type`	string	固定为 `images`

related_image_searches 中的通常：

type: related_image_searches_element
title
alt
url
image_url

`shopping`

购物结果项目通常：

字段	类型	说明
`title`	string	商品标题
`price`	object	商品价格
`source`	string	商品来源
`description`	string	商品描述
`marketplace`	string	商城或商户平台
`marketplace_url`	string	商城 URL
`rating`	object	商品评分
`type`	string	固定为 `shopping`

`popular_products`

热门商品结果通常：

title
seller
image_url
items
items[].snippet
items[].seller
items[].more_sellers
items[].price
items[].rating
items[].product_identifiers

product_identifiers 可能：

字段	类型	说明
`product_id`	string	商品唯一标识
`data_docid`	string	SERP 数据标识
`gid`	string	商品局标识

价格对象 `price`

字段	类型	说明
`current`	float	当前价格
`regular`	float	未折扣的常规价格
`max_value`	float	价格范围中的最高价
`currency`	string	价格币种的 ISO 代码
`is_price_range`	boolean	是否为价格区间
`displayed_price`	string	SERP 中原始展示的价格文本

##、媒体和本地业务结果

`top_stories`

字段	类型	说明
`items`	array	新闻项目
`items[].source`	string	新闻来源
`items[].domain`	string	来源域名
`items[].title`	string	新闻标题
`items[].date`	string	页面发布时间
`items[].amp_version`	boolean	是否有 AMP 版本
`items[].url`	string	新闻 URL
`items[].timestamp`	string	发布时间
`items[].image_url`	string	图片 URL
`items[].badges`	array	新闻标记
`type`	string	固定为 `top_stories`

`video` 与 `short_videos`

视频项目通常：

source
title
url
timestamp
domain
image_url
type

短视频模块的类型为 short_videos，项目类型为 short_videos_element。

`jobs`

职位模块及项目可能：

字段	类型	说明
`title`	string	职位或模块标题
`url`	string	结果 URL
`items`	array	职位项目
`items[].description`	string	职位摘要
`items[].author`	string	发布
`items[].job_posted_time`	string	发布时间
`items[].contract_type`	string	合同类型
`items[].salary`	string	薪资
`items[].timestamp`	string	发布时间
`type`	string	固定为 `jobs`

`events`

事件项目通常：

title
snippet
url
type: events_element

`recipes`

菜谱项目通常：

title
url
domain
source
description
time
rating
type: recipes_element

`top_sights`

景点项目通常：

title
url
description
rating
type: top_sights_element

`scholarly_articles`

学术文章项目通常：

title
url
author
description
rating
type: scholarly_articles_element

`podcasts`

播客项目通常：

title
url
snippet
timestamp
time_to_play
type: podcasts_element

`questions_and_answers`

问答项目通常：

字段	类型	说明
`url`	string	问答来源 URL
`question_text`	string	问题
`answer_text`	string	答案
`source`	string	来源名称
`votes`	integer	投票数
`type`	string	固定为 `questions_and_answers_element`

##店、航班、地图和本地服务

`hotels_pack`

字段	类型	说明
`title`	string	店模块标题
`date_from`	string	住日期，格式为 `YYYY-MM-DD`
`date_to`	string	离店日期，格式为 `YYYY-MM-DD`
`items`	array	店结果
`items[].title`	string	店名称
`items[].url`	string	店 URL
`items[].description`	string	店描述
`items[].domain`	string	域名
`items[].rating`	object	评分
`items[].price`	object	指定日期的住宿价格
`items[].is_paid`	boolean	是否为广告
`type`	string	固定为 `hotels_pack`

`google_hotels`

字段	类型	说明
`hotel_identifier`	string	店唯一标识
`url`	string	店 URL
`type`	string	固定为 `google_hotels`

`google_flights`

字段	类型	说明
`title`	string	航班模块标题
`url`	string	航班 URL
`items`	array	航班结果
`items[].description`	string	航班描述
`items[].url`	string	航班 URL
`type`	string	固定为 `google_flights`

`map`

字段	类型	说明
`title`	string	地图结果标题
`url`	string	地图结果 URL
`type`	string	固定为 `map`

`local_services`

本地服务结果可能：

title
url
domain
description
items
items[].title
items[].url
items[].domain
items[].description
items[].rating
items[].profile_image_url
type: local_services

AI Overview 数据

ai_overview 用于保存搜索结果页中的 AI Overview。该可能异步加载。

字段	类型	说明
`type`	string	固定为 `ai_overview`
`asynchronous_ai_overview`	boolean	是否异步加载；`true` 表示异步加载，`false` 表示从缓存加载
`markdown`	string	Markdown 格式的完整
`items`	array	AI Overview 子
`references`	array	生成所引用的页面
`position`	string	`left` 或 `right`
`xpath`	string	XPath
`traffic_cost`	float	估算流量价值
`rank_group`	integer	组排名
`rank_absolute`	integer	绝对排名
`etv`	float	估算流量

AI Overview 子

子类型：

ai_overview_element
ai_overview_video_element
ai_overview_table_element
ai_overview_expanded_element

`ai_overview_element`

字段	类型	说明
`title`	string	子标题
`text`	string	文本或描述
`markdown`	string	Markdown 格式
`links`	array	引用或链接
`images`	array	图片
`references`	array	参考来源
`type`	string	固定为 `ai_overview_element`

`ai_overview_video_element`

字段	类型	说明
`title`	string	视频标题
`snippet`	string	视频附加说明
`url`	string	视频 URL
`domain`	string	视频网站域名
`image_url`	string	视频缩略图
`source`	string	视频来源
`date`	string	发布或索引日期
`timestamp`	string	发布时间
`type`	string	固定为 `ai_overview_video_element`

`ai_overview_table_element`

字段	类型	说明
`markdown`	string	Markdown 格式表格
`table`	object	表格对象
`table.table_header`	array	表头
`table.table_content`	array	表格行
`references`	array	参考来源
`type`	string	固定为 `ai_overview_table_element`

`ai_overview_expanded_element`

字段	类型	说明
`title`	string	展开标题
`text`	string	展开文本
`components`	array	组件
`components[].type`	string	固定为 `ai_overview_expanded_component`
`components[].title`	string	组件标题
`components[].text`	string	组件文本
`components[].markdown`	string	Markdown 格式文本
`components[].images`	array	组件图片
`components[].links`	array	组件链接
`components[].references`	array	组件引用
`type`	string	固定为 `ai_overview_expanded_element`

AI Overview 引用对象

字段	类型	说明
`type`	string	固定为 `ai_overview_reference`
`source`	string	引用来源名称或标题
`domain`	string	引用域名
`url`	string	引用页面 URL
`title`	string	引用页面标题
`text`	string	用于生成的页面片段

SERP素

`twitter`

可能：

title
url
items
items[].tweet
items[].date
items[].url
items[].timestamp
type: twitter

`mention_carousel`

可能：

title
items
items[].title
items[].price
items[].rating
items[].mentioned_in
type: mention_carousel

`find_results_on`

用于表示在来源或站点中查找结果，通常：

items
items[].title
items[].domain
items[].url
items[].source
type: find_results_on

`stocks_box`

股票模块可能：

title
source
snippet
price
url
domain
table
graph
position
xpath

graph 对象通常：

字段	类型	说明
`items`	array	指定时间点的价格数据
`items[].type`	string	固定为 `graph_element`
`items[].date`	string	时间，ISO 8601 格式
`items[].value`	integer/float	该时间点的价格
`previous_items`	array	前一时间段的收盘数据

股票价格可能存在延迟，不应作为实时金融使用。

`currency_box`

字段	类型	说明
`value`	integer	换算数值
`converted_value`	float	换算后的数值
`currency`	string	原始币种
`converted_currency`	string	目标币种
`timestamp`	string	数据时间
`table`	object	汇率表
`graph`	object	汇率曲线
`type`	string	固定为 `currency_box`

汇率数据可能存在延迟，不应作为实时汇率源使用。

`math_solver`

数学计算模块可能：

title：题目或表达式
result：计算结果
items：解题步骤
items[].type：math_solver_element 或 math_solver_expanded_element
items[].title：步骤标题
items[].solution：步骤
type: math_solver

`product_considerations`

产品考虑因素模块可能：

title
items
items[].title
items[].consideration_category
items[].expanded_element
items[].expanded_element.title
items[].expanded_element.featured_title
items[].expanded_element.breadcrumb
items[].expanded_element.snippet
items[].expanded_element.domain
items[].expanded_element.url
items[].expanded_element.related_searches
items[].expanded_element.about_this_result
type: product_considerations

`refine_products`

产品筛选建议通常：

字段	类型	说明
`title`	string	筛选模块标题
`items`	array	筛选项目
`items[].title`	string	筛选标题
`items[].image_url`	string	图片 URL
`items[].keyword`	string	搜索
`items[].refine_type`	string	筛选类型
`type`	string	固定为 `refine_products`

`explore_brands`

品牌探索模块通常：

title
items
items[].title
items[].url
items[].domain
items[].description
items[].image_url
type: explore_brands

`perspectives`

观点模块通常：

title
items
items[].title
items[].description
items[].url
items[].domain
items[].date
items[].source
items[].timestamp
type: perspectives

`discussions_and_forums`

讨论和论坛模块通常：

title
items
items[].title
items[].url
items[].domain
items[].source
items[].description
items[].timestamp
items[].posts_count
type: discussions_and_forums

`compare_sites`

站点比较模块通常：

title
items
items[].title
items[].url
items[].domain
items[].image_url
items[].source
type: compare_sites

`third_party_reviews`

第三方评价模块通常：

字段	类型	说明
`reviews_count`	integer	评价数量
`title`	string	第三方评价来源名称
`url`	string	第三方评价来源 URL
`rating`	object	评分
`type`	string	固定为 `third_party_reviews`
`position`	string	素位置
`xpath`	string	XPath

附加信息

`extra`

字段	类型	说明
`core_keyword`	string	同组中的核心；没有匹结果时为 `null`
`synonym_clustering_algorithm`	string	同义词聚类算法
`detected_language`	string	系统识别出的语言
`keyword_difficulty`	integer	排名难度

synonym_clustering_algorithm 可能为：

keyword_metrics：基于指标识别同义词
text_processing：基于文本处理识别同义词
null：未识别出对应的同义词

`search_intent_info`

字段	类型	说明
`main_intent`	string	主要搜索意图
`foreign_intent`	array	补搜索意图
`last_updated_time`	string	搜索意图数据更新时间

main_intent 和 foreign_intent 的可能值：

informational：信息型
navigational：导航型
commercial：商业调查型
transactional：交易型

完整数据示例

以下示例展示一条数据库记录的主要结构。数据中的 serp 数组可能更多 SERP 类型及嵌套字段。

json

{
  "keyword": "coleman xtreme 5 cooler",
  "location": 2840,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info_history": {
    "202109": {
      "search_volume": 1300,
      "cpc": 0.422711,
      "competition": 1,
      "competition_level": null,
      "low_top_of_page_bid": null,
      "high_top_of_page_bid": null,
      "time_update": "2021-10-12T18:29:11.9262890Z",
      "categories": [],
      "history": {
        "202010": 1000,
        "202011": 720,
        "202012": 720,
        "202101": 590,
        "202102": 720,
        "202103": 1000,
        "202104": 1600,
        "202105": 2400,
        "202106": 2900,
        "202107": 2400,
        "202108": 1900,
        "202109": 1000
      }
    }
  },
  "serp_info_history": {
    "202109": {
      "check_url": "https://www.google.com/search?q=coleman%20xtreme%205%20cooler&num=100&hl=en&gl=US",
      "items_count": 100,
      "keyword_difficulty": null,
      "se_results_count": 2080000,
      "time_update": "2021-09-28T16:21:09.1487610Z",
      "previous_updated_time": null,
      "item_types": [
        "organic",
        "people_also_ask",
        "product_considerations",
        "ai_overview"
      ],
      "serp": [
        {
          "title": "70 Quart Xtreme 5 Cooler",
          "description": "Food and drinks last longer at the campsite or tailgate.",
          "domain": "www.example.com",
          "main_domain": "example.com",
          "url": "https://www.example.com/product",
          "relative_url": "/product",
          "type": "organic",
          "is_new": false,
          "is_up": false,
          "is_down": false,
          "previous_rank_absolute": 2,
          "rank_info": {
            "page_rank": 148,
            "main_domain_rank": 260
          },
          "position": "left",
          "xpath": "/html/body/div/div/div",
          "traffic_cost": 213.3822,
          "rank_group": 1,
          "rank_absolute": 2,
          "etv": 486.4
        },
        {
          "type": "people_also_ask",
          "items": [
            {
              "type": "people_also_ask_element",
              "title": "How many quarts is the cooler?",
              "seed_question": null,
              "expanded_element": []
            }
          ],
          "position": "left",
          "xpath": "/html/body/div/div/div/div",
          "traffic_cost": 0,
          "rank_group": 1,
          "rank_absolute": 4,
          "etv": 486.4
        },
        {
          "type": "ai_overview",
          "asynchronous_ai_overview": false,
          "markdown": "以下为搜索结果中的 AI Overview。",
          "items": [
            {
              "type": "ai_overview_element",
              "title": "常见问题",
              "text": "这是 AI Overview 的文本。",
              "images": null,
              "references": []
            }
          ],
          "position": "left",
          "xpath": "/html/body/div/div/div/div/div",
          "traffic_cost": 14.592,
          "rank_group": 1,
          "rank_absolute": 1,
          "etv": 145.92
        }
      ]
    }
  },
  "extra": {
    "core_keyword": null,
    "synonym_clustering_algorithm": "keyword_metrics",
    "detected_language": "en",
    "keyword_difficulty": 23
  },
  "search_intent_info": {
    "main_intent": "commercial",
    "foreign_intent": [],
    "last_updated_time": "2023-03-04T13:56:18.6047890Z"
  }
}

时间与格式说明

月份键：YYYYMM，例如 202109。
日期：YYYY-MM-DD，例如 2022-05-12。
ISO 8601 时间：YYYY-MM-DDThh:mm:ss.sssssssZ。
UTC 时间：yyyy-mm-dd hh-mm-ss +00:00。
XPath 字段保留原始 SERP 页面路径。
没有数据的字段通常返回 null、空数组 [] 或空对象，取决于字段类型。
SERP素的字段结构会随类型变化，解析时应始终判断 type，再读取对应字段。

实用场景

回溯排名变化：比较不同月份的 serp_info_history、rank_absolute 和 previous_rank_absolute，定位排名上升或下降的时间点及竞争页面。
监测 SERP 特征占位：统计 featured_snippet、people_also_ask、ai_overview、top_stories 和 local_pack 等的出现频率，制定和结构化数据优化策略。
评估商业价值：结合 search_volume、cpc、competition、etv 和 traffic_cost，筛选高流量、高转化潜力的 SEO 。
分析竞争对手可见性：按域名聚合 organic、paid、shopping 和本地结果，比较竞争对手在不同 SERP 模块中的覆盖。
识别与搜索意图变化：结合 search_intent_info、related_searches、people_also_ask 和 product_considerations，发现用户需求变化并优化选题。

Google 历史 SERP 高级数据库 ​

概述 ​

数据文件 ​

计费 ​

数据结构 ​

spell_type 可选值 ​

历史指标 ​

历史 SERP 数据 ​

keyword_difficulty ​

item_types 可选值 ​

SERP 通用字段 ​

自然结果 organic ​

images ​

rating ​

links ​

faq ​

about_this_result ​

付费结果 paid ​

常见 SERP 特征字段 ​

carousel 与 multi_carousel ​

answer_box ​

featured_snippet ​

people_also_ask ​

related_searches 与 people_also_search ​

local_pack ​

knowledge_graph ​

图片、购物和商品结果 ​

images ​

shopping ​

popular_products ​

价格对象 price ​

Google 历史 SERP 高级数据库

概述

数据文件

计费

数据结构

`spell_type` 可选值

历史指标

历史 SERP 数据

`keyword_difficulty`

`item_types` 可选值

SERP 通用字段

自然结果 `organic`

`images`

`rating`

`links`

`faq`

`about_this_result`

付费结果 `paid`

常见 SERP 特征字段

`carousel` 与 `multi_carousel`

`answer_box`

`featured_snippet`

`people_also_ask`

`related_searches` 与 `people_also_search`

`local_pack`

`knowledge_graph`

图片、购物和商品结果

`images`

`shopping`

`popular_products`

价格对象 `price`