高级 SERP 数据库

概述

这是一个旧版文档页。建议优参考新版接口文档：/v3/databases/google/serp_advanced/。

高级 SERP 数据库收录了 5 亿个 Google 搜索结果页，并丰富的 SERP 扩展，例如富摘要、知识图谱、精选摘要、本地结果、图片、视频等。

本数据库提供 JSON 格式。

计费说明

该数据库的费用取决于数据库规模与地域参数。

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

数据结构说明

高级 SERP 数据库中的每条记录通常以下顶层字段。

顶层字段

字段	类型	说明
keyword	string	搜索，使用 UTF-8 编码
location	integer	地区代码，唯一标识目标地区
language	string	语言代码，唯一标识目标语言
spell	string	搜索引擎自动纠错后的
spell_type	string	自动纠错类型
keyword_info	object	返回的数据
bing_keyword_info	object	基于 Bing Ads 的数据部分地区和语言支持
serp_info	object	返回对应的 SERP 信息
serp	array	该对应的 SERP素列表
extra	object/array	附加信息

地区与语言代码获取

可通过以下接口获取支持的 location_code 和 language_code：

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

示例：

• 2840 表示 United States
• en 表示 English

---

自动纠错字段

字段	类型	说明
spell	string	如果搜索引擎对进行了纠错并返回了纠错结果，则该字段表示纠错后的
spell_type	string	自动纠错类型，可选值：did_you_mean、showing_results_for、no_results_found_for

---

keyword_info 字段说明

keyword_info 表示当前返回的指标数据。

字段	类型	说明
search_volume	integer	平均月搜索量
cpc	float	平均点击成本，单位 USD
competition	float	竞争度，范围 0 到 1
time_update	string	数据最近更新时间，ISO 8601 格式，如 2020-09-12T00:07:43.0733218Z
categories	array	产品与服务分类列表
history	object	月度搜索量历史

补说明：

• search_volume 表示 Google 上该的近似月均搜索次数。
• cpc 为历史平均点击成本。
• competition 基于广告数据计算，数值越高表示竞争越强。
• categories 为产品或服务分类。
• history 采用 YYYYMM 作为键，例如 202002: 140。

---

bing_keyword_info 字段说明

bing_keyword_info 表示基于 Bing Ads 的数据。 注意：部分地区和语言提供该数据。

字段	类型	说明
search_volume	integer	Bing 月搜索量
time_update	string	数据最近更新时间，ISO 8601 格式
history	object	月度 Bing 搜索量历史

---

serp_info 字段说明

serp_info 描述当前的 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	上一次更新的时间，ISO 8601 格式
item_types	array	当前 SERP 中的结果类型列表

keyword_difficulty 说明

该指标表示前 10 个自然结果的难度，取值范围为 0-100，基于前 10 个页面的外链画像等参数综合计算。

item_types 可选值

answer_box, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, images, jobs, knowledge_graph, local_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, find_results_on, stocks_box, visual_stories, commercial_units, local_services, knowledge_graph_carousel_item, knowledge_graph_description_item, knowledge_graph_expanded_item, knowledge_graph_images_item, knowledge_graph_list_item, knowledge_graph_row_item, knowledge_graph_part_item, knowledge_graph_shopping_item, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, hotels_pack, google_hotels, math_solver

---

serp 字段说明

serp 为数组，该对应 SERP 中识别出的各类。不同 type 的字段结构不同。

下面按主要类型说明。

---

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/null	附加站点链接
domain	string	完整域名
main_domain	string	主域名，不含子域
url	string	结果绝对 URL
relative_url	string	相对 URL
is_malicious	boolean	是否被标记为恶意
faq	object/null	FAQ 扩展块
type	string	固定为 organic
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	“此结果”面板信息
time_stamp / timestamp	string	发布时间，UTC 格式
is_web_story	boolean	是否为 Web Story
rank_group	integer	同类型组排名
rank_absolute	integer	SERP 绝对排名
position	string	展示位置，left 或 right
xpath	string	素 XPath
etv	float	预估流量
impressions_etv	float	基于展示量的预估流量
traffic_cost	float	预估流量价值/买量成本

images 子

字段	类型	说明
type	string	固定为 images_element
alt	string	图片 alt 文本
url	string	对应页面 URL
image_url	string	图片 URL

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	链接 URL

faq 结构

字段	类型	说明
type	string	固定为 faq_box
items	array	FAQ 列表

FAQ 列表：

字段	类型	说明
type	string	固定为 faq_box_element
title	string	问题
description	string	展开后的答案
links	array	FAQ部链接

price 结构

字段	类型	说明
current	float	当前价格
regular	float	原价
max_value	float	最高价格
currency	string	货币 ISO 代码
is_price_range	boolean	是否价格区间
displayed_price	string	原始展示价格文本

related_result 子

字段	类型	说明
type	string	固定为 related_result
xpath	string	XPath
domain	string	域名
title	string	标题
url	string	结果 URL
cache_url	string	缓存页
related_search_url	string	类似搜索链接
breadcrumb	string	面屑
is_image	boolean	是否含图
is_video	boolean	是否含视频
description	string	描述
pre_snippet	string	前置摘要
extended_snippet	string	后置摘要
images	array	图片
amp_version	boolean	是否 AMP
rating	object	评分
price	object	价格
highlighted	array	加粗词
about_this_result	object	“此结果”信息

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	搜索词

---

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/null	扩展描述
links	array/null	广告站点链接
type	string	固定为 paid
is_new	boolean	是否为新广告
is_up	boolean	是否上升
is_down	boolean	是否下降
previous_rank_absolute	integer	上次绝对排名
price	object	价格信息
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	left / right
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	基于展示量的预估流量
traffic_cost	float	月度流量成本估算

paid.extra

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

广告站点链接 links：

字段	类型	说明
type	string	固定为 ad_link_element
title	string	链接标题
url	string	链接 URL
description	string	描述
ad_aclk	string	广告标识符

---

常见 SERP素类型

以下为本数据库中常见的 type，均保留核心结构字段。

carousel

字段	类型	说明
title	string	模块标题
items	array	轮播项
type	string	carousel
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	left / right
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

轮播项：

字段	类型	说明
type	string	carousel_element
title	string	项目标题
sub_title	string	副标题

multi_carousel

字段	类型	说明
type	string	multi_carousel
items	array	轮播项
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	left / right
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

轮播项：

字段	类型	说明
type	string	multi_carousel_element
title	string	标题
multi_carousel_snippets	array	细分轮播

answer_box

字段	类型	说明
text	array	文本
links	array	链接
type	string	answer_box
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

featured_snippet

字段	类型	说明
title	string	标题
featured_title	string	来源页面标题
description	string	摘要描述
table	object/null	表格结果
type	string	featured_snippet
domain	string	域名
main_domain	string	主域名
url	string	URL
relative_url	string	相对 URL
is_new	boolean	是否新结果
is_up	boolean	是否上升
is_down	boolean	是否下降
previous_rank_absolute	integer	上次绝对排名
images	array	图片
timestamp	string	发布时间
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

top_stories

字段	类型	说明
items	array	新闻项
type	string	top_stories
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

新闻项：

字段	类型	说明
type	string	top_stories_element
source	string	来源
domain	string	域名
title	string	标题
date	string	发布日期
url	string	URL
timestamp	string	时间戳

twitter

字段	类型	说明
title	string	标题
url	string	URL
items	array	推文列表
type	string	twitter
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

推文项：

字段	类型	说明
type	string	twitter_element
tweet	string	推文
date	string	发布日期
url	string	URL
timestamp	string	发布时间

map

字段	类型	说明
title	string	标题
url	string	URL
type	string	map
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

images

字段	类型	说明
title	string	标题
url	string	URL
items	array	图片项
related_image_searches	array	图片搜索
type	string	images
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

video

字段	类型	说明
items	array	视频项
type	string	video
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

视频项：

字段	类型	说明
type	string	video_element
source	string	视频来源
title	string	标题
url	string	URL
timestamp	string	发布时间

people_also_ask

字段	类型	说明
items	array	问答项
type	string	people_also_ask
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

问答项：

字段	类型	说明
type	string	people_also_ask_element
title	string	问题标题
xpath	string	XPath
expanded_element	object	展开后的答案

related_searches

字段	类型	说明
items	array	搜索列表
type	string	related_searches
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

people_also_search

字段	类型	说明
title	string	标题
items	array	推荐项
type	string	people_also_search
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

local_pack

字段	类型	说明
title	string	名称
description	string	描述
phone	string	电话
is_paid	boolean	是否为广告
rating	object	评分
domain	string	域名
main_domain	string	主域名
url	string	URL
relative_url	string	相对 URL
type	string	local_pack
is_new	boolean	是否为新结果
is_up	boolean	是否上升
is_down	boolean	是否下降
previous_rank_absolute	integer	上次绝对排名
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

knowledge_graph

知识图谱类型结构较复杂，通常主标题、副标题、描述、卡片 ID、URL，以及多个细分子项。

主字段：

字段	类型	说明
title	string	标题
sub_title	string	副标题
description	string	描述
card_id	string	卡片 ID
url	string	URL
items	array	知识图谱子
type	string	knowledge_graph
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	位置
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	展示预估流量
traffic_cost	float	流量成本

常见子类型：

• 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

这些子结构通常标题、文本、链接、图片、价格、表格或扩展信息。

---

支持的 SERP素类型

除上述重点类型外，数据库还支持以下结构化，字段含义与命名保持一致，可按返回结果解析：

• 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
• google_reviews
• google_flights
• math_solver

这些普遍以下字段：

字段	类型	说明
type	string	素类型
rank_group	integer	组排名
rank_absolute	integer	绝对排名
position	string	left / right
xpath	string	XPath
etv	float	预估流量
impressions_etv	float	基于展示量的预估流量
traffic_cost	float	预估流量成本

如涉及项，通常通过 items 数组返回；若涉及价格、评分、表格、图表等附加信息，则会返回 price、rating、table、graph 等对象。

---

extra 字段说明

字段	类型	说明
core_keyword	string	组的核心

说明：

• 如果 core_keyword 为 null，表示数据库中未找到满足相似性条件的组核心词。

---

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": 0.5306122448979591,
 "time_update": "2020-09-12T00:07:43.0733218Z",
 "categories": [],
 "history": {
 "201902": 140,
 "201903": 170,
 "201904": 90,
 "201905": 90,
 "201906": 70,
 "201907": 70,
 "201908": 110,
 "201909": 90,
 "201910": 90,
 "201911": 70,
 "201912": 90,
 "202001": 50,
 "202002": 140
 }
 },
 "bing_keyword_info": {
 "search_volume": 52,
 "time_update": "2020-09-12T00:07:43.0733218Z",
 "history": {
 "201902": 140,
 "201903": 170,
 "201904": 90,
 "201905": 90,
 "201906": 70,
 "201907": 70,
 "201908": 110,
 "201909": 90,
 "201910": 90,
 "201911": 70,
 "201912": 90,
 "202001": 50,
 "202002": 140
 }
 },
 "serp_info": {
 "check_url": "https://www.google.com/search?q=st%20mark%27s%20campanile%20tickets&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
 "keyword_difficulty": 67,
 "items_count": 84,
 "se_results_count": 73,
 "time_update": "2020-09-12T00:07:43.0733218Z",
 "item_types": []
 },
 "extra": {
 "core_keyword": null
 }
}

调用说明

该页面主要描述数据库字段结构，原始未提供对应请求方法与任务创建示例。 如需检索或调用新版能力，建议参考容路径下的 SERP 数据库接口文档。

如您的接场景需要统一认证，Authorization 头请使用：

Authorization: Bearer smt_live_YOUR_KEY

curl 示例

curl -X GET "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 -H "Authorization: Bearer smt_live_YOUR_KEY"

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

TypeScript 示例

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

console.log(response.status);
console.log(await response.text);

注意事项

1. 本页为旧版字段说明页，推荐优使用新版路径：/v3/databases/google/serp_advanced/
2. 数据库返回为 JSON 结构化结果，不同 type 对应不同字段集合。
3. serp 数组中的类型很多，解析时建议基于 type 分支处理。
4. 某些字段可能返回 null，例如无站点链接、无价格信息、无 FAQ 等。
5. 部分数据源能力依赖地区与语言，例如 bing_keyword_info 并非所有地区都可用。

实用场景

• 识别 SERP 版位结构：分析某页面中是否出现精选摘要、知识图谱、PAA、本地等，帮助评估自然点击机会与竞争格局。
• 监控自然结果变化：利用 is_new、is_up、is_down、previous_rank_absolute 跟踪页面排名波动，支持竞品监控和排名预警。
• 评估难度与流量价值：结合 keyword_difficulty、search_volume、cpc、traffic_cost，判断 SEO 投产出比。
• 提取富结果特征：解析 faq、rating、price、images、about_this_result 等字段，制定结构化数据优化和富摘要占位策略。
• 发现选题与扩展词：从 related_searches、people_also_ask、people_also_search、top_stories 中提取用户问题与主题，扩展规划。