Bing 高级 SERP 数据库

GET /v3/dataforseo_labs/locations_and_languages

Bing 高级 SERP 数据库数百万条 Bing 搜索结果页数据，并提供精选摘要、知识图谱、本地结果、视频、购物等扩展 SERP 特征。

数据库提供 JSON 格式。

数据库按、地区和语言组织。每条记录数据、SERP 汇总信息以及 SERP素。部分字段可能为 null，表示搜索结果中不存在对应。

数据获取

可根据目标地区、语言和数据库规模下载相应数据文件。数据库示例和支持的地区列表请通过本平台控制台或参考文档获取。

地区与语言代码可通过以下接口查询：

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

请求示例：

curl --request GET \
  --url https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages \
  --header 'Authorization: Bearer smt_live_YOUR_KEY'

示例：

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

计费说明

数据库费用取决于数据库的规模、地区和语言参数。

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

数据字段

顶层字段

字段	类型	说明
keyword	string	搜索，使用 UTF-8 编码。
location	integer	地区代码，对应地区的唯一标识。
language	string	语言代码，对应地区可用语言的唯一标识。
spell	string	搜索引擎自动修正后的。如果搜索引擎对原进行了修正，则返回修正后的；否则为 null。
spell_type	string	自动修正类型。可选值：did_you_mean、showing_results_for、no_results_found_for、including_results_for。
keyword_info	object	返回的搜索量和历史数据。
serp_info	object	返回对应的 SERP 数据。
extra	array	附加信息。当前数据库中通常为 null。

keyword_info 字段

字段	类型	说明
search_volume	integer	平均月搜索量，表示指定地区中该的近似月搜索次数。
competition	float	竞争度，取值范围为 0 至 1，边界值。该字段对美国地区提供数据。
cpc	float	平均每次点击费用。原始数据以口径计算；该字段对美国地区提供数据。
time_update	string	数据最后更新时间，使用 ISO 8601 格式，例如 2020-09-12T00:07:43.0733218Z。
history	object	按月统计的搜索量。对象键格式为 YYYYMM，值为对应月份的近似搜索量。

示例：

{
  "search_volume": 40,
  "competition": 0.1,
  "cpc": 0,
  "time_update": "2022-04-18T14:04:05.9075575Z",
  "history": {
    "202201": 50,
    "202202": 30,
    "202203": 50
  }
}

serp_info 字段

字段	类型	说明
check_url	string	可直接访问的搜索结果页 URL，可用于核对返回结果。
items_count	integer	serp 数组中的 SERP素数量。
keyword_difficulty	integer	排名难度，取值范围为 0 至 100，用于表示前 10 个自然结果的难度。该指标基于前 10 个 SERP 页面及链接特征等数据计算。
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
carousel
events
featured_snippet
hotels_pack
images
jobs
local_pack
map
organic
paid
people_also_ask
people_also_search
questions_and_answers
recipes
related_searches
shopping
top_stories
video

SERP素通用字段

多数 SERP素以下排名和流量字段：

字段	类型	说明
type	string	SERP素类型，例如 organic、paid、images。
position	string	素在 SERP 中的对齐位置，可选值为 left、right。
xpath	string	素在搜索结果页中的 XPath。
rank_group	integer	同类型中的组排名。不同类型之间不计算该字段。
rank_absolute	integer	素在整个 SERP 中的绝对排名。
is_new	boolean	与数据库上一版本相比，该是否为新增。
is_up	boolean	与上一版本相比，该排名是否上升。
is_down	boolean	与上一版本相比，该排名是否下降。
previous_rank_absolute	integer	上一版本中的绝对排名。没有历史排名时为 null。
traffic_cost	float	将预估自然流量转换为付费流量的估算月成本。通常基于 etv 与 cpc 计算。
etv	float	预估月自然流量，通常基于点击率与搜索量计算。
rank_info	object	页面和主域名的排名信息。

rank_info 字段

字段	类型	说明
page_rank	integer	页面排名指标。
main_domain_rank	integer	不含子域名的主域名排名指标。

自然结果：organic

自然结果的类型固定为 organic，常见字段如下：

字段	类型	说明
title	string	搜索结果标题。
domain	string	SERP 中显示的完整域名。
main_domain	string	不含子域名的主域名。
url	string	结果的绝对 URL。
relative_url	string	结果的相对 URL。
description	string	搜索结果描述。
pre_snippet	string	添加在结果描述前的附加文本。
extended_snippet	string	添加在结果描述后的附加文本。
breadcrumb	string	搜索结果面屑。
highlighted	array	描述中被搜索引擎加粗显示的词语。
cache_url	string	页面缓存 URL。
is_malicious	boolean	是否被标记为恶意页面。
is_image	boolean	结果是否图片。
is_video	boolean	结果是否视频。
is_featured_snippet	boolean	结果是否为精选摘要。
amp_version	boolean	是否存在 AMP 版本。
links	array	站链接。如果没有，则为 null。
faq	object	FAQ 扩展信息，没有时为 null。
related_result	array	来自同一域名的结果。
related_search_url	string	搜索 URL。
extended_people_also_search	array	搜索词扩展信息。
about_this_result	object	“此结果”信息，没有时为 null。
is_web_story	boolean	是否为网页。
timestamp	string	结果发布时间，使用 UTC 格式。
rating	object	结果评分信息。
price	object	商品或服务价格信息。

评分字段：rating

字段	类型	说明
rating_type	string	评分类型，可选值为 Max5、Percents、CustomMax。
value	integer	评分值。
votes_count	integer	评价数量。
rating_max	integer	当前评分类型对应的最大评分值。

价格字段：price

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

站链接字段：links

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

FAQ 字段：faq

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

FAQ 子项字段：

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

付费结果：paid

付费结果的类型固定为 paid。

字段	类型	说明
title	string	广告标题。
domain	string	广告结果中的完整域名。
main_domain	string	不含子域名的主域名。
description	string	广告描述。
breadcrumb	string	广告面屑。
url	string	广告目标绝对 URL。
relative_url	string	广告目标相对 URL。
highlighted	array	广告描述中被加粗的词语。
extra	object	广告附加信息。
description_rows	array	扩展描述，没有时为 null。
links	array	广告站链接，没有时为 null。
price	object	广告中展示的价格信息。
ad_aclk	string	广告标识符。

广告站链接的字段：

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

图片结果：images

字段	类型	说明
title	string	图片结果标题。
url	string	图片结果页 URL。
items	array	图片条目列表，没有时为 null。
related_image_searches	array	图片搜索词和图片。

图片条目字段：

字段	类型	说明
type	string	固定为 images_element。
alt	string	图片 alt 文本。
url	string	原始图片 URL。
image_url	string	图片 URL。

图片搜索条目字段：

字段	类型	说明
type	string	固定为 related_image_searches_element。
title	string	可用于细化图片搜索的。
alt	string	推荐图片的替代文本。
url	string	推荐图片的原始 URL。
image_url	string	压缩图片 URL。

精选摘要：featured_snippet

字段	类型	说明
type	string	固定为 featured_snippet。
title	string	精选摘要标题。
featured_title	string	精选摘要来源页面标题。
description	string	精选摘要描述。
table	object	表格，没有时为 null。
domain	string	来源域名。
main_domain	string	不含子域名的主域名。
url	string	来源页面 URL。
relative_url	string	来源页面相对 URL。
images	array	精选摘要中的图片。
timestamp	string	发布时间。

table 对象字段：

字段	类型	说明
table_header	array	表格列名。
table_content	array	表格，每个数组表示一行。

问答结果：answer_box

字段	类型	说明
type	string	固定为 answer_box。
text	array	答案文本，没有时为 null。
links	array	答案框中的链接，没有时为 null。

链接子项字段：

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

轮播结果：carousel

字段	类型	说明
type	string	固定为 carousel。
title	string	轮播模块标题。
items	array	轮播条目，没有时为 null。

轮播条目字段：

字段	类型	说明
type	string	固定为 carousel_element。
title	string	条目标题。
subtitle	string	条目副标题。

搜索结果：related_searches

字段	类型	说明
type	string	固定为 related_searches。
items	array	搜索项，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

“用户还搜索了”结果：people_also_search

字段	类型	说明
type	string	固定为 people_also_search。
title	string	模块标题。
items	array	搜索项，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

“用户还提问”结果：people_also_ask

字段	类型	说明
type	string	固定为 people_also_ask。
items	array	问题列表，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

问题条目字段：

字段	类型	说明
type	string	固定为 people_also_ask_element。
title	string	问题标题。
xpath	string	问题在页面中的 XPath。
expanded_element	array	展开后的答案。

展开可能：

字段	类型	说明
type	string	固定为 people_also_ask_expanded_element。
featured_title	string	来源标题。
url	string	来源 URL。
domain	string	来源域名。
title	string	标题。
description	string	描述。
table	object	表格答案，没有时为 null。
timestamp	string	发布时间。

本地结果：local_pack

字段	类型	说明
type	string	固定为 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。

地图结果：map

字段	类型	说明
type	string	固定为 map。
title	string	地图结果标题。
url	string	地图结果 URL。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

视频结果：video

字段	类型	说明
type	string	固定为 video。
items	array	视频条目，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

视频条目字段：

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

热门资讯：top_stories

字段	类型	说明
type	string	固定为 top_stories。
items	array	热门资讯条目，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

热门资讯条目字段：

字段	类型	说明
type	string	固定为 top_stories_element。
source	string	资讯来源。
domain	string	来源域名。
title	string	资讯标题。
date	string	页面发布时间。
url	string	资讯 URL。
timestamp	string	资讯模块的时间。

购物结果：shopping

字段	类型	说明
type	string	固定为 shopping。
title	string	购物模块标题。
items	array	商品列表，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

商品条目字段：

字段	类型	说明
type	string	固定为 shopping_element。
title	string	商品标题。
price	object	商品价格信息。
source	string	商品信息来源。
description	string	商品描述。
marketplace	string	商品所在商城或商家平台。
marketplace_url	string	商品在商城中的页面 URL。

工作、活动和食谱结果

工作结果：jobs

字段	类型	说明
type	string	固定为 jobs。
title	string	工作模块标题。
url	string	工作结果 URL。
items	array	招聘条目，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

招聘条目可能：

type
title
description
author
job_posted_time
contract_type
salary
url
timestamp

活动结果：events

字段	类型	说明
type	string	固定为 events。
url	string	活动结果 URL。
title	string	活动模块标题。
items	array	活动条目，没有时为 null。

活动条目字段：

字段	类型	说明
type	string	固定为 events_element。
title	string	活动标题。
snippet	string	活动摘要。
url	string	活动 URL。

食谱结果：recipes

字段	类型	说明
type	string	固定为 recipes。
items	array	食谱条目，没有时为 null。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

食谱条目字段：

type
title
url
domain
source
description
time
rating

time 表示菜品准备所需的总时间，rating 使用通用评分对象结构。

##店结果：hotels_pack

字段	类型	说明
type	string	固定为 hotels_pack。
title	string	店模块标题。
date_from	string	住日期，格式为 YYYY-MM-DD。
date_to	string	离店日期，格式为 YYYY-MM-DD。
items	array	店结果列表。

条目字段：

字段	类型	说明
type	string	固定为 hotels_pack_element。
title	string	地点或名称。
url	string	店 URL。
desription	string	原始字段名，表示描述。
domain	string	店域名。
rating	object	店评分。
price	object	指定日期的预订价格。
is_paid	boolean	是否为广告结果。
position	string	对齐位置。
xpath	string	页面 XPath。
traffic_cost	float	预估付费流量成本。
rank_group	integer	组排名。
rank_absolute	integer	绝对排名。
etv	float	预估月自然流量。

JSON 数据示例

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

{
  "keyword": "0 23 as a fraction",
  "location": 2840,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 40,
    "competition": 0.1,
    "cpc": 0,
    "time_update": "2022-04-18T14:04:05.9075575Z",
    "history": {
      "202201": 50,
      "202202": 30,
      "202203": 50
    }
  },
  "serp_info": {
    "check_url": "https://www.bing.com/search?q=0%2023%20as%20a%20fraction",
    "items_count": 2,
    "keyword_difficulty": 58,
    "se_results_count": 41,
    "time_update": "2022-04-24T13:41:00.9015527Z",
    "previous_updated_time": "2022-03-19T05:28:45.4966790Z",
    "item_types": [
      "organic",
      "paid"
    ],
    "serp": [
      {
        "title": "示例自然搜索结果",
        "domain": "example.com",
        "main_domain": "example.com",
        "url": "https://example.com/example-page",
        "relative_url": "/example-page",
        "description": "搜索结果描述",
        "is_malicious": false,
        "type": "organic",
        "is_new": true,
        "is_up": false,
        "is_down": false,
        "previous_rank_absolute": null,
        "rank_info": {
          "page_rank": 160,
          "main_domain_rank": 640
        },
        "position": "left",
        "xpath": "/html/body/div/main/ol/li",
        "traffic_cost": 0.2619,
        "rank_group": 1,
        "rank_absolute": 1,
        "etv": 0.291
      },
      {
        "title": "示例广告结果",
        "domain": "advertiser.example",
        "main_domain": "advertiser.example",
        "url": "https://advertiser.example/product",
        "relative_url": "/product",
        "description": "广告描述",
        "highlighted": null,
        "extra": {
          "ad_aclk": null
        },
        "type": "paid",
        "is_new": true,
        "is_up": false,
        "is_down": false,
        "previous_rank_absolute": null,
        "rank_info": {
          "page_rank": 148,
          "main_domain_rank": 664
        },
        "position": "left",
        "xpath": "/html/body/div/main/ol/li/ul/li",
        "traffic_cost": 1.2798,
        "rank_group": 1,
        "rank_absolute": 2,
        "etv": 1.422
      }
    ]
  },
  "extra": null
}

实用场景

• 对比不同的 SERP 特征分布，识别精选摘要、本地结果、视频和购物模块的触发规律，从而制定对应的和结构化数据策略。
• 监控目标的自然结果排名变化，结合 is_new、is_up、is_down 和 previous_rank_absolute 定位竞争对手排名波动，及时调整 SEO 优化计划。
• 评估的自然流量潜力，使用 search_volume、etv、traffic_cost 和 keyword_difficulty 计算优级与获客成本。
• 分析本地搜索结果中的商家、电话、评分和付费标记，优化本地 SEO 页面、门店信息和区域化营销策略。
• 挖掘“用户还搜索了”和“用户还提问”中的问题，扩展主题、FAQ 模块和长尾覆盖范围。