Google 高级 SERP 数据库

概述

Google 高级 SERP 数据库收录了海量 Google 搜索结果页，并提供丰富的 SERP 特征数据但不限于精选摘要、知识图谱、People Also Ask、Top Stories、图片、视频、本地结果、购物结果、AI Overview 等。

除指标与结构化 SERP素数据外，本数据库还为自然结果提供页面权重与主域名权重信息，这些指标基于平台链接索引计算得出。

该数据库提供 JSON 格式。

示例数据：可按指定国家/语言下载数据库样例
地区与语言列表：可通过接口 /v3/dataforseo_labs/locations_and_languages 获取支持的 location_code 与 language_code

计费说明

该数据库的费用取决于数据库的规模与地区参数。原始文档未给出固定单价，因此无法换算为统一人民币参考价。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

数据说明

顶层字段

字段	类型	说明
`keyword`	string	查询，采用 UTF-8 编码
`location`	integer	地区代码，对应唯一地区标识
`language`	string	语言代码，对应指定地区可用语言
`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	搜索意图信息

地区与语言代码获取

可调用以下容接口获取支持的地区和语言：

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

认证头示例：

Authorization: Bearer smt_live_YOUR_KEY

示例：

2840 表示美国
en 表示英语

`keyword_info` 字段说明

字段	类型	说明
`search_volume`	integer	平均月搜索量，表示 google.com 上该的大致月搜索次数
`cpc`	float	平均点击费用，单位为 USD；该值基于广告竞价数据中的 `high_top_of_page_bid` 推导
`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	月度搜索量历史，键格式通常为 `YYYYMM`

`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、ai_overview

通用 SERP素字段

多数 serp素会以下通用字段：

字段	类型	说明
`type`	string	素类型
`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	上一版本中的绝对排名

主要 SERP素结构

下文保留最核心、最常用的字段定义。由于该数据库支持的 SERP素类型非常多，返回时应以 type 为准进行解析。

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	返回 SERP 后展开的搜索扩展
`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	评分上限

`rank_info` 结构

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

`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	词

2. `paid` 付费结果

字段	类型	说明
`title`	string	广告标题
`domain`	string	广告结果域名
`description`	string	广告描述
`breadcrumb`	string	广告面屑
`url`	string	广告绝对 URL
`main_domain`	string	主域名
`relative_url`	string	相对 URL
`highlighted`	array	加粗词
`extra`	object	附加信息，如 `ad_aclk`
`description_rows`	array	扩展描述行
`links`	array	广告附加链接
`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	展开后的回答

展开中可能：

普通回答块
表格回答
图片
链接
AI Overview 扩展回答
视频回答
引用来源 references

5. `knowledge_graph` 知识图谱

字段	类型	说明
`title`	string	实体标题
`subtitle`	string	副标题
`description`	string	描述
`card_id`	string	卡片 ID
`url`	string	URL
`logo_url`	string	Logo URL
`items`	array	图谱中的子

支持的子较多，常见类型：

knowledge_graph_description_item
knowledge_graph_list_item
knowledge_graph_carousel_item
knowledge_graph_images_item
knowledge_graph_row_item
knowledge_graph_part_item
knowledge_graph_shopping_item
knowledge_graph_expanded_item
knowledge_graph_ai_overview_item

这些子通常：

title
text
link / links
items
data_attrid
price
image_url
references

6. 常见 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
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
courses
ai_overview
third_party_reviews

`ai_overview` 字段说明

AI Overview 是当前高级 SERP 数据库中的重点结构之一。

字段	类型	说明
`type`	string	固定为 `ai_overview`
`asynchronous_ai_overview`	boolean	是否异步加载
`markdown`	string	Markdown 格式文本
`items`	array	AI Overview块
`references`	array	引用来源

`ai_overview_element`

字段	类型	说明
`title`	string	区块标题
`text`	string	区块文本
`markdown`	string	Markdown
`links`	array	链接列表
`images`	array	图片列表
`references`	array	引用来源

AI Overview 子

ai_overview_video_element：视频类结果
ai_overview_table_element：表格类结果
ai_overview_expanded_element：扩展说明块
ai_overview_reference：引用来源对象

`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	主搜索意图
`foreign_intent`	array	助搜索意图
`last_updated_time`	string	搜索意图数据最近更新时间

搜索意图可能值

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

示例数据结构

下面是该数据库 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",
 "history": {
 "201902": 140,
 "201903": 170
 }
 },
 "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",
 "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,
 "rank_info": {
 "page_rank": 148,
 "main_domain_rank": 634
 },
 "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",
 "is_new": true,
 "previous_rank_absolute": 0,
 "rank_info": {
 "page_rank": 151,
 "main_domain_rank": 932
 },
 "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... Skin Irritation..."
 }
 ],
 "references": [],
 "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"
 }
}

调用示例

说明：该页面描述的是数据库数据结构，本身不是一个独立采集任务接口。若需获取地区/语言等信息，可调用容接口 /v3/dataforseo_labs/locations_and_languages。

cURL

bash

curl -X GET "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 -H "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.json)

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);

使用建议

解析 serp 数组时，务基于 type 做分支处理，不同 SERP素字段差异很大。
对 ai_overview、people_also_ask、knowledge_graph 这类嵌套结构，建议使用递归或类型映射方式解析。
rank_group 与 rank_absolute 含义不同：前是同类型排序，后是 SERP 绝对位置。
若需跟踪排名变化，请 is_new、is_up、is_down、previous_rank_absolute。
若需评估自然流量价值，可结合 etv、traffic_cost、keyword_info.cpc 一并分析。

实用场景

识别 SERP 版位机会：分析下是否出现精选摘要、PAA、AI Overview、视频、图片等模块，帮助团队决定优做哪种形态。
监控自然结果波动：利用 is_up、is_down、previous_rank_absolute 跟踪页面排名变化，快速发现核心词流量异常。
评估竞争强度：结合 keyword_difficulty、rank_info、competition 判断目标词的 SEO 门槛，优化选词策略。
拆解对手占位结构：提取竞争对手在 organic、featured_snippet、local_pack、shopping 等模块中的表现，制定差异化与投放策略。
构建搜索意图模型：基于 search_intent_info、PAA、搜索、AI Overview 引用源，完善意图分类与规划。

Google 高级 SERP 数据库 ​

概述 ​

计费说明 ​

数据说明 ​

顶层字段 ​

地区与语言代码获取 ​

keyword_info 字段说明 ​

serp_info 字段说明 ​

item_types 可能值 ​

通用 SERP素字段 ​

主要 SERP素结构 ​

1. organic 自然结果 ​

rating 结构 ​

rank_info 结构 ​

about_this_result 结构 ​

2. paid 付费结果 ​

3. featured_snippet 精选摘要 ​

4. people_also_ask 大家还会问 ​

people_also_ask_element ​

5. knowledge_graph 知识图谱 ​

6. 常见 SERP 类型 ​

ai_overview 字段说明 ​

ai_overview_element ​

AI Overview 子 ​

extra 字段说明 ​

search_intent_info 字段说明 ​

搜索意图可能值 ​

示例数据结构 ​

调用示例 ​

cURL ​

Python ​

TypeScript ​