Bing量数据库

概述

Bing量数据库是一个统一搜索数据库，整合了两类数据：

高级 Bing SERP 数据库：覆盖海量 Bing 搜索结果页，并精选摘要、知识图谱等扩展 SERP 特性；
Bing 数据库：覆盖海量搜索词，并附带搜索量历史、当前搜索量、CPC、竞争度等指标。

该数据库提供 JSON 格式。

数据样例：可下载美国地区、英文语言样例数据
地区与语言列表：可通过位置/语言接口获取支持范围

获取支持的地区与语言列表：

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

计费说明

该数据库的费用取决于的数据量与地区参数。

由于平台按库规模与地域动态计费，本文不固定列出单价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

数据结构说明

下面说明数据库中主要字段的含义。

顶层字段

字段	类型	说明
`keyword`	string	搜索词，使用 UTF-8 编码
`location`	integer	地区代码，对应唯一地区标识。例如 `2840` 表示美国
`language`	string	语言代码，对应该地区可用语言。例如 `en` 表示英语
`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`	array / null	附加信息；当前通常为 `null`

`keyword_info` 字段

字段	类型	说明
`search_volume`	integer	平均月搜索量
`competition`	float	竞争度，范围 `0` 到 `1`；美国地区有值
`cpc`	float	历史平均点击成本，单位 USD；美国地区有值
`time_update`	string	数据最近更新时间，ISO 8601 格式，如 `2020-09-12T00:07:43.0733218Z`
`history`	object	过去 4 年按月统计的搜索量历史，键格式通常为 `YYYYMM`

`serp_info` 字段

字段	类型	说明
`check_url`	string	搜索结果直达链接，可用于核验 SERP
`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、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素类型
`position`	string	素在页面中的布局位置，可为 `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素结构。

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	站点链接（sitelinks）
`domain`	string	完整域名
`main_domain`	string	主域名，不含子域名
`url`	string	绝对 URL
`relative_url`	string	相对 URL
`is_malicious`	boolean	是否被标记为恶意
`faq`	object	FAQ 扩展块
`extended_people_also_search`	array	搜索扩展
`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	评分值
`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 中展示的原始价格文本

`rank_info` 结构

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

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) `carousel` 轮播结果

字段	类型	说明
`title`	string	模块标题
`items`	array	轮播项列表

子项通常：

字段	类型	说明
`type`	string	固定为 `carousel_element`
`title`	string	子项标题
`subtitle`	string	子项副标题

4) `answer_box` 直接答案

字段	类型	说明
`text`	array	答案文本
`links`	array	链接

5) `related_searches` 搜索

字段	类型	说明
`items`	array	搜索项

6) `people_also_search` 用户还会搜索

字段	类型	说明
`title`	string	模块标题
`items`	array	扩展搜索项

7) `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
`rank_info`	object	页面与域名权重信息

8) `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	页面与域名权重信息

9) `top_stories` 热门新闻

字段	类型	说明
`items`	array	新闻项列表

子项通常：

字段	类型	说明
`type`	string	固定为 `top_stories_element`
`source`	string	来源站点
`domain`	string	来源域名
`title`	string	标题
`date`	string	发布日期
`url`	string	链接
`timestamp`	string	收录时间

10) `map` 地图结果

字段	类型	说明
`title`	string	标题
`url`	string	地图链接

11) `video` 视频结果

字段	类型	说明
`items`	array	视频项列表

子项通常：

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

12) `people_also_ask` 大家还会问

字段	类型	说明
`items`	array	问题列表

问题项通常：

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

展开项通常：

字段	类型	说明
`featured_title`	string	标题
`url`	string	链接
`domain`	string	域名
`title`	string	结果标题
`description`	string	描述
`table`	object	表格
`type`	string	固定为 `people_also_ask_expanded_element`
`timestamp`	string	发布时间

13) `images` 图片结果

字段	类型	说明
`title`	string	模块标题
`url`	string	图片搜索链接
`items`	array	图片项列表
`related_image_searches`	array	图片搜索建议

图片项通常：

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

图片搜索项通常：

字段	类型	说明
`type`	string	固定为 `related_image_searches_element`
`title`	string	建议补
`alt`	string	推荐图片 alt
`url`	string	原图地址
`image_url`	string	压缩图地址

14) `shopping` 购物结果

字段	类型	说明
`title`	string	模块标题
`items`	array	商品项列表

商品项通常：

字段	类型	说明
`type`	string	固定为 `shopping_element`
`title`	string	商品标题
`price`	object	价格信息
`source`	string	信息来源
`description`	string	商品描述
`marketplace`	string	商城或聚合平台
`marketplace_url`	string	商城页面地址

15) `jobs` 职位结果

字段	类型	说明
`title`	string	模块标题
`url`	string	链接
`items`	array	职位项列表

职位项通常：

字段	类型	说明
`type`	string	固定为 `jobs_element`
`title`	string	职位名称
`description`	string	摘要
`author`	string	发布方
`job_posted_time`	string	发布时间
`contract_type`	string	合同类型
`salary`	string	薪资
`url`	string	链接
`timestamp`	string	结果发布时间

16) `events` 活动结果

字段	类型	说明
`type`	string	固定为 `events`
`url`	string	模块链接
`title`	string	模块标题
`items`	array	活动项列表

活动项通常：

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

17) `recipes` 菜谱结果

字段	类型	说明
`type`	string	固定为 `recipes`
`items`	array	菜谱项列表

菜谱项通常：

字段	类型	说明
`type`	string	固定为 `recipes_element`
`title`	string	菜谱标题
`url`	string	链接
`domain`	string	域名
`source`	string	来源
`description`	string	摘要
`time`	string	制作时长
`rating`	object	评分信息

18) `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	链接
`desription`	string	描述
`domain`	string	域名
`rating`	object	评分信息
`price`	object	指定日期对应的价格
`is_paid`	boolean	是否广告

时间字段格式

文档中的时间字段常见格式如下：

ISO 8601：YYYY-MM-DDThh:mm:ss.sssssssZ
UTC 文本格式：yyyy-mm-dd hh-mm-ss +00:00

示例：

2020-09-12T00:07:43.0733218Z
2019-11-15 12:57:46 +00:00

地区与语言代码

可通过以下接口获取完整支持列表：

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

返回数据中可使用：

location_code：地区代码
language_code：语言代码

JSON 数据示例

以下示例展示数据库中的记录结构：

json

{
 "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": {
 "202104": 60,
 "202105": 40,
 "202106": 20,
 "202107": 10,
 "202108": 20,
 "202109": 70,
 "202110": 80,
 "202111": 60,
 "202112": 20,
 "202201": 50,
 "202202": 30,
 "202203": 50
 }
 },
 "serp_info": {
 "check_url": "https://www.bing.com/search?q=0%2023%20as%20a%20fraction&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&form=QBLH",
 "items_count": 19,
 "keyword_difficulty": 58,
 "se_results_count": 41,
 "time_update": "2022-04-24T13:41:00.9015527Z",
 "previous_updated_time": "2022-03-19T05:28:45.4966790Z"
 },
 "extra": null
}

获取地区语言列表示例

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

TypeScript

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

使用说明

该页面描述的是数据库结构，不是一个独立的实时查询任务接口。接时建议按以下方式使用：

通过 /v3/dataforseo_labs/locations_and_languages 获取可用地区和语言；
根据业务需要选择目标地区、语言和数据样本；
按 JSON 结构解析 keyword_info 与 serp_info；
针对不同 type 的 SERP素建立分层解析逻辑；
将 rank_absolute、item_types、keyword_difficulty、search_volume 等字段用于研究与 SERP 分析。

注意事项

数据库提供 JSON 格式；
competition 与 cpc 字段在美国地区有值；
某些嵌套字段可能为 null；
serp不同 type 的结构差异较大，解析时需按类型分支处理；
item_types 用于快速判断当前 SERP 中出现了哪些模块；
check_url 可用于人工校验搜索结果页。

实用场景

**筛选高价值 Bing **：结合 search_volume、cpc、competition 与 keyword_difficulty，快速定位值得投放或优化的。
分析 SERP 版位结构：统计 item_types、rank_absolute 和各类 SERP 模块分布，判断自然结果是否被图片、问答、新闻等模块挤压。
监控排名环境变化：通过 is_new、is_up、is_down、previous_rank_absolute 跟踪同一 SERP 变化，发现竞争对手或退出。
挖掘选题与问答需求：利用 people_also_ask、related_searches、people_also_search 提炼用户问题和主题，指导策划。
评估本地与垂类流量机会：分析 local_pack、shopping、jobs、hotels_pack 等模块，识别本地服务、电商、招聘、等垂类搜索机会。

Bing量数据库 ​

概述 ​

计费说明 ​

数据结构说明 ​

顶层字段 ​

keyword_info 字段 ​

serp_info 字段 ​

item_types 可能值 ​

SERP素通用字段 ​

主要 SERP素说明 ​

1) organic 自然结果 ​

rating 结构 ​

price 结构 ​

rank_info 结构 ​

2) paid 付费结果 ​

3) carousel 轮播结果 ​

4) answer_box 直接答案 ​

5) related_searches 搜索 ​

6) people_also_search 用户还会搜索 ​

7) local_pack 本地结果 ​

8) featured_snippet 精选摘要 ​

9) top_stories 热门新闻 ​

10) map 地图结果 ​

11) video 视频结果 ​

12) people_also_ask 大家还会问 ​

13) images 图片结果 ​

14) shopping 购物结果 ​

15) jobs 职位结果 ​

16) events 活动结果 ​

17) recipes 菜谱结果 ​

18) hotels_pack店结果 ​

时间字段格式 ​

Bing量数据库

概述

计费说明

数据结构说明

顶层字段

`keyword_info` 字段

`serp_info` 字段

`item_types` 可能值

SERP素通用字段

主要 SERP素说明

1) `organic` 自然结果

`rating` 结构

`price` 结构

`rank_info` 结构

2) `paid` 付费结果

3) `carousel` 轮播结果

4) `answer_box` 直接答案

5) `related_searches` 搜索

6) `people_also_search` 用户还会搜索

7) `local_pack` 本地结果

8) `featured_snippet` 精选摘要

9) `top_stories` 热门新闻

10) `map` 地图结果

11) `video` 视频结果

12) `people_also_ask` 大家还会问

13) `images` 图片结果

14) `shopping` 购物结果

15) `jobs` 职位结果

16) `events` 活动结果

17) `recipes` 菜谱结果

18) `hotels_pack`店结果

时间字段格式