Advanced SERP 数据库

GET /v3/dataforseo_labs/locations_and_languages

概述

Advanced SERP 数据库为历史容版本， 5 亿条搜索结果页数据，并提供富摘要、知识图谱、精选摘要、本地结果、购物结果等 SERP 特征。

本数据库提供 JSON 格式。当前页面为旧版文档，接口字段可能与新版数据库接口存在差异。

> 本页面未定义可直接调用的 HTTP 方法和 /v3/... 请求路径，主要用于说明数据库记录结构。请以新版接口文档中的请求路径为准。

计费说明

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

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

数据结构

基础字段

字段	类型	说明
keyword	string	搜索查询词，使用 UTF-8 编码。
location	integer	地域代码，对应地域的唯一标识。可通过以下接口获取可用地域及 location_code：https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages。例如，2840 表示美国。
language	string	语言代码，对应地域可用语言的唯一标识。可通过地域与语言接口获取 language_code。例如，en 表示英语。
spell	string/null	搜索引擎自动纠正后的。如果搜索引擎对查询词进行了纠正，则返回纠正后的。
spell_type	string	自动纠正类型。可选值：did_you_mean、showing_results_for、no_results_found_for。
extra	object	附加信息。
extra.core_keyword	string/null	组中的核心。如果为 null，表示数据库中没有找到符合条件的。

数据

keyword_info

的搜索量和广告数据。

字段	类型	说明
keyword_info.search_volume	integer	平均月搜索量，表示指定在目标搜索市场中的估算月搜索次数。
keyword_info.cpc	float	平均每次点击费用。原始数据以广告平台使用的货币返回。
keyword_info.competition	float	竞争度，取值范围为 0 到 1，边界值。
keyword_info.time_update	string	数据最近更新时间，使用 ISO 8601 格式，例如 2020-09-12T00:07:43.0733218Z。
keyword_info.categories	array	产品和服务分类。
keyword_info.history	object	按月份记录的历史搜索量。键通常使用 YYYYMM 格式，例如 202002。

bing_keyword_info

基于另一搜索广告数据源的数据。该数据覆盖有限的地域和语言组合。

字段	类型	说明
bing_keyword_info.search_volume	integer	最近一个月的搜索次数。
bing_keyword_info.time_update	string	数据最近更新时间，使用 ISO 8601 格式。
bing_keyword_info.history	object	按月份记录的历史搜索量，键使用 YYYYMM 格式。

SERP 汇总数据

serp_info

字段	类型	说明
serp_info.check_url	string	可直接访问的搜索结果页 URL，可用于核验返回结果。
serp_info.items_count	integer	serp 数组中返回的结果数量。
serp_info.keyword_difficulty	integer	排名难度，取值范围为 0 到 100。该指标基于前 10 个自然结果的链接等因素计算，数值越高表示前 10 名越困难。
serp_info.se_results_count	integer	搜索结果页中的结果总数。
serp_info.time_update	string	SERP 数据最近更新时间，使用 ISO 8601 格式。
serp_info.previous_updated_time	string	SERP 数据上一次更新时间，使用 ISO 8601 格式。
serp_info.item_types	array	当前 SERP 中的结果类型。
serp_info.serp	array	当前对应的 SERP素列表。

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 数组中的大多数会以下排名和流量字段：

字段	类型	说明
type	string	SERP素类型。
rank_group	integer	在相同 type素组中的排名。不同类型不会计该排名。
rank_absolute	integer	在所有 SERP素中的绝对排名。
position	string	素在 SERP 中的对齐位置，可为 left 或 right。
xpath	string	素在结果页中的 XPath。
is_new	boolean	与数据库上一版本相比，是否为新增。
is_up	boolean	与上一版本相比，排名是否上升。
is_down	boolean	与上一版本相比，排名是否下降。
previous_rank_absolute	integer/null	上一版本中的绝对排名。
etv	float/null	估算月自然流量，通常根据点击率与搜索量计算。
impressions_etv	float/null	基于展示次数估算的月流量。
traffic_cost	float/null	通过付费搜索获得相同自然流量时的估算月成本。

自然结果：organic

自然结果通常：

字段	类型	说明
title	string	结果标题。
pre_snippet	string	结果描述前附加显示的信息。
description	string	结果描述。
extended_snippet	string	结果描述后附加显示的信息。
breadcrumb	string	面屑路径。
domain	string	结果域名。
main_domain	string	去除子域名后的主域名。
url	string	结果绝对 URL。
relative_url	string	结果相对 URL。
cache_url	string	页面缓存 URL。
is_malicious	boolean	是否被标记为恶意结果。
is_image	boolean	是否图片。
is_video	boolean	是否视频。
is_featured_snippet	boolean	是否为精选摘要来源。
amp_version	boolean	是否存在 AMP 版本。
highlighted	array	描述中被加粗显示的。
links	array/null	站点链接。无站点链接时为 null。
faq	object/null	常见问题扩展。无该扩展时为 null。
related_result	array	来自同一域名的结果。
related_search_url	string	搜索 URL。
extended_people_also_search	array	搜索词扩展，通常在用户返回搜索结果页时出现。
about_this_result	object	结果附加信息。
rating	object	结果评分信息。
price	object	商品或服务价格信息。

评分字段

rating 对象：

字段	类型	说明
rating_type	string	评分类型，可为 Max5、Percents 或 CustomMax。
value	integer/float	评分值。
votes_count	integer	评价数量。
rating_max	integer	评分最大值。

价格字段

price 对象：

字段	类型	说明
current	float	当前价格。
regular	float	未打折的常规价格。
max_value	float	价格区间中的最高价格。
currency	string	价格货币的 ISO 代码。
is_price_range	boolean	是否为价格区间。
displayed_price	string	结果页原始展示的价格文本。

站点链接字段

links 数组中的通常：

字段	类型	说明
type	string	固定为 link_element。
title	string	链接标题。
description	string	链接描述。
url	string	站点链接 URL。

常见问题字段

faq 对象通常：

字段	类型	说明
type	string	固定为 faq_box。
items	array	问答项列表。
items[].type	string	固定为 faq_box_element。
items[].title	string	问题文本。
items[].description	string	展开后显示的答案。
items[].links	array	问答项中的链接。

广告结果：paid

付费结果通常：

字段	类型	说明
title	string	广告标题。
domain	string	广告结果完整域名。
main_domain	string	去除子域名后的主域名。
description	string	广告描述。
breadcrumb	string	广告面屑。
url	string	广告绝对 URL。
relative_url	string	广告相对 URL。
highlighted	array	描述中加粗显示的词语。
extra	object	广告附加信息。
extra.ad_aclk	string	广告标识符。
description_rows	array/null	扩展描述行。没有时为 null。
links	array/null	广告站点链接。
price	object	广告结果中的价格信息。
is_new	boolean	是否为新增广告。
is_up	boolean	排名是否上升。
is_down	boolean	排名是否下降。
previous_rank_absolute	integer/null	上一版本绝对排名。

本地结果：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。

图片、视频与社交结果

images

图片结果可能：

• title：结果标题；
• url：图片搜索 URL；
• items：图片列表；
• items[].type：固定为 images_element；
• items[].alt：图片替代文本；
• items[].url：原始图片 URL；
• items[].image_url：压缩图片 URL；
• related_image_searches：图片搜索词及图片；
• rank_group、rank_absolute、position、xpath；
• etv、impressions_etv、traffic_cost。

video

视频结果可能：

• items：视频列表；
• items[].type：固定为 video_element；
• items[].source：视频来源；
• items[].title：视频标题；
• items[].url：视频 URL；
• items[].timestamp：发布时间；
• 通用排名与流量字段。

twitter

社交结果可能：

• title：结果标题；
• url：结果 URL；
• items[].type：固定为 twitter_element；
• items[].tweet：帖子正文；
• items[].date：发布日期；
• items[].url：帖子 URL；
• 通用排名与流量字段。

精选摘要与问答结果

featured_snippet

字段	类型	说明
title	string	结果标题。
featured_title	string	精选摘要来源页面标题。
description	string	结果描述。
table	object/null	表格数据。
table.table_header	array	表头。
table.table_content	array	表格。
domain	string	结果域名。
main_domain	string	主域名。
url	string	结果 URL。
relative_url	string	相对 URL。
images	array	结果图片。
timestamp	string	发布时间。

同时新增、排名变化、排名位置及流量估算字段。

answer_box

字段	类型	说明
text	array/null	答案文本。
links	array/null	答案中的链接。
type	string	固定为 answer_box。
rank_group	integer	分组排名。
rank_absolute	integer	绝对排名。
position	string	left 或 right。
xpath	string	XPath。
etv	float/null	估算流量。
impressions_etv	float/null	基于展示次数的估算流量。
traffic_cost	float/null	估算流量成本。

people_also_ask

常见字段：

• items：问题列表；
• items[].type：固定为 people_also_ask_element；
• items[].title：问题标题；
• items[].xpath：问题 XPath；
• items[].expanded_element：展开后的答案；
• expanded_element.featured_title：答案来源标题；
• expanded_element.url：来源 URL；
• expanded_element.domain：来源域名；
• expanded_element.description：答案描述；
• expanded_element.table：答案表格；
• expanded_element.timestamp：发布时间；
• 通用排名与流量字段。

轮播、知识图谱与搜索

carousel

• items：轮播项；
• items[].type：carousel_element；
• items[].title：轮播项标题；
• items[].sub_title：轮播项副标题；
• 以及通用排名和流量字段。

multi_carousel

• items[].type：multi_carousel_element；
• items[].title：轮播项标题；
• items[].multi_carousel_snippets：嵌套轮播结果；
• multi_carousel_snippets[].type：multi_carousel_snippet；
• multi_carousel_snippets[].title：嵌套项标题；
• 以及通用排名和流量字段。

related_searches

• items：搜索项；
• type：固定为 related_searches；
• 以及通用排名和流量字段。

people_also_search

• title：结果标题；
• items：搜索项；
• items[].type：people_also_search；
• items[].title：搜索标题；
• 以及通用排名和流量字段。

knowledge_graph

知识图谱结果可能：

字段	类型	说明
title	string	知识图谱标题。
sub_title	string	副标题。
description	string	描述文本。
card_id	string	卡片标识。
url	string	URL。
items	array	知识图谱子。
data_attrid	string	搜索引擎定义的数据属性标识，例如 action:listen_artist。
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_shopping_item
• knowledge_graph_expanded_item

常见子字段：

• title、subtitle、text；
• url、domain、image_url、alt；
• link、links；
• items、expanded_element；
• table、table_header、table_content；
• price、source、snippet；
• 通用排名与流量字段。

：

• knowledge_graph_description_item 提供描述文本及链接；
• knowledge_graph_images_item 提供图片链接、替代文本和图片 URL；
• knowledge_graph_list_item 提供列表项及数据属性标识；
• knowledge_graph_row_item 提供行标题、文本和链接；
• knowledge_graph_part_item 提供知识图谱分区；
• knowledge_graph_shopping_item 提供商品标题、价格、来源和商城信息；
• knowledge_graph_expanded_item 提供展开区域、特色标题和表格数据。

商品、服务与结果

shopping

购物结果可能：

• title：商品标题；
• items：商品列表；
• items[].type：shopping_element；
• items[].price：商品价格；
• items[].source：商品来源；
• items[].description：商品描述；
• items[].marketplace：商城或商户平台名称；
• items[].marketplace_url：商城 URL；
• 通用排名与流量字段。

popular_products

热门商品结果可能：

• items[].type：popular_products_element；
• title：商品标题；
• snippet：商品摘要；
• price：价格信息；
• rating：评分信息；
• 通用排名与流量字段。

commercial_units

商业单可能：

• title：模块标题；
• items[].type：commercial_units_element；
• items[].title：商品或服务标题；
• items[].url、domain：结果链接和域名；
• items[].price：价格；
• items[].source：来源；
• items[].rating：评分；
• 通用排名与流量字段。

local_services

本地服务结果可能：

• title、url、domain：模块信息；
• items[].type：local_services_element；
• items[].title：服务名称；
• items[].url、domain：服务链接和域名；
• items[].description：服务描述；
• items[].rating：评分；
• items[].profile_image_url：服务商头像或图片；
• 通用排名与流量字段。

hotels_pack

模块可能：

字段	类型	说明
title	string	模块标题。
date_from	string	住日期，格式为 YYYY-MM-DD。
date_to	string	离店日期，格式为 YYYY-MM-DD。
items	array	店结果列表。
items[].type	string	固定为 hotels_pack_element。
items[].title	string	店或地点名称。
items[].url	string	店 URL。
items[].desription	string	店描述。该字段名按原始数据保留。
items[].domain	string	店域名。
items[].rating	object	店评分。
items[].price	object	指定日期的价格。
items[].is_paid	boolean	是否为广告。

google_hotels

字段	类型	说明
hotel_identifier	string	店唯一标识，例如 CgoIjaeSlI6CnNpVEAE。
url	string	店结果 URL。
type	string	素类型。
rank_group	integer	分组排名。
rank_absolute	integer	绝对排名。
position	string	left 或 right。
xpath	string	XPath。
etv	float/null	估算流量。
impressions_etv	float/null	基于展示次数的估算流量。

recipes

食谱结果可能：

• items[].type：recipes_element；
• title：食谱标题；
• url、domain：食谱链接和域名；
• source：来源；
• description：摘要；
• time：准备和烹饪所需总时间；
• rating：评分；
• 通用排名与流量字段。

top_sights

热门景点结果可能：

• items[].type：top_sights_element；
• title：景点名称；
• url：景点 URL；
• description：景点摘要；
• rating：景点评分；
• 通用排名与流量字段。

新闻、职位、活动和媒体结果

top_stories

• items[].type：top_stories_element；
• source：来源；
• domain：来源域名；
• title：标题；
• date：发布日期；
• url： URL；
• timestamp：结果页的时间；
• 通用排名与流量字段。

jobs

• title：职位结果标题；
• url：职位 URL；
• items[].type：jobs_element；
• items[].title：职位名称；
• items[].description：职位摘要；
• items[].author：发布；
• items[].job_posted_time：发布时间；
• items[].contract_type：合同类型；
• items[].salary：薪资信息；
• items[].timestamp：发布时间；
• 通用排名与流量字段。

events

• url：活动模块 URL；
• title：活动标题；
• items[].type：events_element；
• items[].title：活动名称；
• items[].snippet：活动摘要；
• items[].url：活动 URL；
• 通用排名与流量字段。

podcasts

• items[].type：podcasts_element；
• title：节目标题；
• url：节目 URL；
• snippet：节目摘要；
• timestamp：节目时间；
• time_to_play：节目时长；
• 通用排名与流量字段。

scholarly_articles

• items[].type：scholarly_articles_element；
• title：文章标题；
• url：文章 URL；
• author：；
• description：文章摘要；
• rating：评分或评价信息；
• 通用排名与流量字段。

visual_stories

• items[].type：visual_stories_element；
• title：视觉标题；
• url： URL；
• domain：域名；
• 通用排名与流量字段。

questions_and_answers

• items[].type：questions_and_answers_element；
• url：问答 URL；
• question_text：问题文本；
• answer_text：答案文本；
• source：答案来源；
• votes：投票数；
• 通用排名与流量字段。

SERP素

map

• title：地图结果标题；
• url：地图结果 URL；
• type：固定为 map；
• 以及通用排名与流量字段。

mention_carousel

• title：模块标题；
• items[].type：mention_carousel_element；
• items[].title：提及项标题；
• items[].price：价格；
• items[].rating：评分；
• items[].mentioned_in：提及该项目的附加结果；
• 通用排名与流量字段。

find_results_on

• items[].type：find_results_on_element；
• title：结果标题；
• domain：来源域名；
• url：结果 URL；
• source：来源；
• 通用排名与流量字段。

google_reviews

字段	类型	说明
reviews_count	integer	评价数量。
place_id	string	地点唯一标识。
feature	string	评价附加特征。
type	string	固定为 google_reviews。
rank_group	integer	分组排名。
rank_absolute	integer	绝对排名。
position	string	left 或 right。
xpath	string	XPath。

google_posts

字段	类型	说明
posts_id	string	帖子功能标识。
feature	string	附加特征标识。
cid	string	本地商户唯一标识，可用于获取该商户的完整评价列表。
type	string	固定为 google_posts。
rank_group	integer	分组排名。
rank_absolute	integer	绝对排名。
position	string	left 或 right。
xpath	string	XPath。

股票和汇率结果

stocks_box

股票模块可能：

字段	类型	说明
title	string	股票结果标题。
source	string	数据来源。
snippet	string	股票摘要。
price	object	抓取结果时的股票报价。
url	string	结果 URL。
domain	string	结果域名。
table	object/null	股票表格数据。
graph	object	股票走势图数据。
graph.items	array	当前时间段的价格点。
graph.previous_items	array	上一时间段的收盘数据。

走势图：

字段	类型	说明
type	string	固定为 graph_element。
date	string	时间，格式为 yyyy-mm-ddThh:mm:ss。
value	integer	对应时间的股票价格。

股票价格可能存在延迟，不能作为实时交易报价依据。

currency_box

汇率模块可能：

字段	类型	说明
value	integer	转换数值。
converted_value	float	转换后的数值。
currency	string	原始货币。
converted_currency	string	目标货币。
timestamp	string	结果发布时间，使用 UTC 格式。
table	object/null	汇率表格。
graph	object	汇率走势图。
graph.items	array	当前时间段的汇率数据。
graph.previous_items	array/null	上一时间段的汇率数据。

汇率走势图：

• type：固定为 graph_element；
• date：时间，格式为 yyyy-mm-ddThh:mm:ss；
• value：指定时间的汇率或上一时间段汇率。

汇率可能存在延迟，以结果抓取时间为准。

math_solver

数学计算结果可能：

字段	类型	说明
title	string	数学表达式标题。
result	string	表达式计算结果。
items	array	解题步骤列表。
items[].type	string	math_solver_element。
items[].title	string	解题步骤标题。
items[].expanded_element	array	展开的详细步骤。
expanded_element[].type	string	math_solver_expanded_element。
expanded_element[].title	string	详细步骤标题。
expanded_element[].solution	array	该步骤的解法。

时间字段格式

接口中常见时间格式如下：

• ISO 8601：2020-09-12T00:07:43.0733218Z
• UTC 日期时间：2019-11-15 12:57:46 +00:00
• 日期：2019-11-15
• 图表时间：2020-10-28T15:45:00

JSON 数据示例

以下示例展示数据库记录的主要结构。部分 SERP素字段会根据结果类型动态出现。

{
  "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,
      "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",
    "keyword_difficulty": 67,
    "items_count": 84,
    "se_results_count": 73,
    "time_update": "2020-09-12T00:07:43.0733218Z",
    "previous_updated_time": "2020-09-11T00:07:43.0733218Z",
    "item_types": [
      "carousel",
      "organic",
      "local_pack",
      "featured_snippet"
    ],
    "serp": [
      {
        "type": "organic",
        "title": "示例结果标题",
        "description": "示例结果描述",
        "domain": "example.com",
        "main_domain": "example.com",
        "url": "https://example.com/page",
        "relative_url": "/page",
        "is_new": true,
        "is_up": false,
        "is_down": true,
        "previous_rank_absolute": null,
        "rank_group": 1,
        "rank_absolute": 1,
        "position": "left",
        "xpath": "/html/body/div",
        "etv": 27.36,
        "impressions_etv": 0,
        "traffic_cost": 9.59236128
      },
      {
        "type": "featured_snippet",
        "title": "示例精选摘要",
        "featured_title": "示例来源页面",
        "description": "精选摘要",
        "table": null,
        "domain": "example.com",
        "main_domain": "example.com",
        "url": "https://example.com/answer",
        "relative_url": "/answer",
        "rank_group": 1,
        "rank_absolute": 2,
        "position": "left",
        "xpath": "/html/body/div/div",
        "etv": 48.5184,
        "impressions_etv": 0,
        "traffic_cost": 265.7936929536
      }
    ]
  },
  "extra": {
    "core_keyword": null
  }
}

实用场景

• 监测 SERP 特征：统计精选摘要、问答框、知识图谱、购物和本地结果的出现频率，优化结构与搜索结果占位策略。
• 评估竞争难度：结合 keyword_difficulty、自然结果排名和历史搜索量，筛选适合资源的。
• 分析竞争对手自然排名：提取 organic 结果中的域名、排名、估算流量和流量成本，建立竞争网站与页面表现对比。
• 挖掘选题：利用 people_also_ask、related_searches、people_also_search 和精选摘要，扩展问答型及长尾。
• 优化本地与电商搜索策略：分析 local_pack、local_services、shopping、popular_products 和 commercial_units 数据，改进本地商户页、商品页和结构化。