databases/bing/full

GET /v3/dataforseo_labs/locations_and_languages

统一搜索 Bing 数据库

本资源为 Bing 完整数据库，原始页面未定义可直接调用的 HTTP 方法和 API 路径。数据库通常以 JSON 文件形式提供，不通过 /wp/... 路径访问。

Bing 完整数据库由以下两部分组成：

• 高级 Bing SERP 数据库：数百万个 Bing 搜索结果页，并提供精选摘要、知识图谱等 SERP 特征。
• Bing 数据库：数百万个搜索词，以及搜索量历史、当前搜索量、每次点击费用（CPC）和竞争度等数据。

数据库提供 JSON 格式。

数据下载与支持范围

• 数据库示例：美国地区、英语语言的 JSON 压缩文件。
• 支持的地区和语言：可下载 CSV 格式的完整列表。支持范围可能随版本更新。
• 地区和语言代码可通过以下接口查询：

GET https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages
Authorization: Bearer smt_live_YOUR_KEY

例如：

• location: 2840 表示美国。
• language: en 表示英语。

计费说明

数据库费用取决于数据库的规模以及地区参数。

参考价需根据所选数据范围确认；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

数据结构

数据库中的每条记录对应一个，并可能同时指标、SERP 汇总信息和 SERP素明细。

顶层字段

字段	类型	说明
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	过去 4 年的月度搜索量。对象键采用 YYYYMM 格式，例如 202204: 40。

serp_info 字段

字段	类型	说明
check_url	string	指向搜索结果页的直接 URL，可用于核对返回的 SERP。
items_count	integer	serp 数组中返回的结果数量。
keyword_difficulty	integer	排名难度，表示前 10 个自然结果的难度，按 0 至 100 的对数尺度计算。
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	素在 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 与付费点击费用计算。
etv	float	预估月自然流量，通常根据点击率（CTR）与搜索量计算。
rank_info	object	页面和主域名排名信息。
page_rank	integer	页面排名指标。
main_domain_rank	integer	主域名排名指标。

自然结果：organic

自然结果可能以下字段：

字段	类型	说明
title	string	搜索结果标题。
pre_snippet	string	结果描述前附加的信息。
description	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	结果是否为精选摘要。
extended_snippet	string	结果描述后附加的信息。
amp_version	boolean	结果是否提供 AMP 版本。
highlighted	array	结果描述中以粗体突出显示的词语。
links	array	结果下方显示的站点链接；没有时为 null。
faq	object	常见问题扩展；没有时为 null。
related_search_url	string	相近搜索的 URL。
related_result	array	来自同一域名的结果。
extended_people_also_search	array	自然结果的搜索扩展，通常在用户点击结果后返回搜索结果页时出现。
about_this_result	object	“此结果”信息结果来源及上下文；没有时为 null。
is_web_story	boolean	结果是否被标记为网页。
timestamp	string	结果发布时间，使用 UTC 格式 yyyy-mm-dd hh-mm-ss +00:00。
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	SERP 中原样展示的价格字符串。

links 及 faq

站点链接字段：

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

FAQ素字段：

字段	类型	说明
type	string	FAQ 容器为 faq_box，FAQ 子项为 faq_box_element。
items	array	FAQ 问答项列表。
title	string	问题标题。
description	string	展开区域中的答案。
links	array	FAQ 子项中的链接列表。

付费结果：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	string	广告标识符。
description_rows	array	扩展描述，没有时为 null。
links	array	广告站点链接，没有时为 null。
price	object	广告中展示的价格信息。
rank_info	object	页面和主域名排名信息。
position	string	位置，可能值为 left、right。
xpath	string	页面 XPath。
traffic_cost	float	付费流量成本估算。
rank_group	integer	同类型的组排名。
rank_absolute	integer	SERP 绝对排名。
etv	float	预估自然流量。

广告链接的 type 为 ad_link_element，字段 title、url、description 和 ad_aclk。

SERP素

carousel 轮播

字段	类型	说明
title	string	轮播模块标题。
items	array	轮播项目列表，没有时为 null。
items[].type	string	固定为 carousel_element。
items[].title	string	项目标题。
items[].subtitle	string	项目副标题。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

answer_box 答案框

字段	类型	说明
text	array	答案文本，没有时为 null。
links	array	答案框中的站点链接，没有时为 null。
links[].type	string	固定为 link_element。
links[].title	string	链接标题。
links[].description	string	链接描述。
links[].url	string	链接 URL。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

related_searches 搜索

字段	类型	说明
items	array	搜索项目，没有时为 null。
type	string	固定为 related_searches。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

people_also_search 用户也搜索

字段	类型	说明
title	string	模块标题。
items	array	搜索项目，没有时为 null。
items[].type	string	固定为 people_also_search。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

people_also_ask 用户还问

字段	类型	说明
items	array	问题列表，没有时为 null。
items[].type	string	固定为 people_also_ask_element。
items[].title	string	问题标题。
items[].xpath	string	问题 XPath。
items[].expanded_element	array	展开的问答。
expanded_element[].type	string	固定为 people_also_ask_expanded_element。
featured_title	string	精选标题。
url	string	URL。
domain	string	结果域名。
description	string	结果描述。
table	object	结果表格，没有时为 null。
table_header	array	表头。
table_content	array	表格，每个数组表示一行。
timestamp	string	结果发布时间，使用 UTC 格式。

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。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

featured_snippet 精选摘要

字段	类型	说明
title	string	结果标题。
featured_title	string	精选摘要来源页面标题。
description	string	摘要描述。
table	object	结果表格，没有时为 null。
table_header	array	表头。
table_content	array	表格。
domain	string	结果完整域名。
main_domain	string	不含子域名的主域名。
url	string	结果绝对 URL。
relative_url	string	结果相对 URL。
images	array	摘要中的图片。
timestamp	string	发布时间，使用 UTC 格式。
rank_info、position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

top_stories 热门资讯

字段	类型	说明
items	array	资讯项目列表，没有时为 null。
items[].type	string	固定为 top_stories_element。
items[].source	string	资讯来源。
items[].domain	string	来源域名。
items[].title	string	资讯标题。
items[].date	string	页面发布时间。
items[].url	string	资讯 URL。
items[].timestamp	string	资讯结果页的时间。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

map 地图结果

字段	类型	说明
title	string	地图结果标题。
url	string	地图结果 URL。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

video 视频结果

字段	类型	说明
items	array	视频项目列表，没有时为 null。
items[].type	string	固定为 video_element。
items[].source	string	视频来源。
items[].title	string	视频标题。
items[].url	string	视频 URL。
items[].timestamp	string	视频发布时间，使用 UTC 格式。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

images 图片结果

字段	类型	说明
title	string	图片模块标题。
url	string	图片结果页 URL。
items	array	图片项目列表，没有时为 null。
items[].type	string	固定为 images_element。
items[].alt	string	图片替代文本。
items[].url	string	图片原始页面 URL。
items[].image_url	string	图片 URL。
related_image_searches	array	图片搜索词和图片。
related_image_searches[].type	string	固定为 related_image_searches_element。
related_image_searches[].title	string	可用于细化图片搜索的。
related_image_searches[].alt	string	图片替代文本。
related_image_searches[].url	string	原始图片 URL。
related_image_searches[].image_url	string	压缩图片 URL。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

shopping 购物结果

字段	类型	说明
title	string	购物模块标题。
items	array	商品列表，没有时为 null。
items[].type	string	固定为 shopping_element。
items[].title	string	商品标题。
items[].price	object	商品价格信息。
items[].source	string	商品信息来源。
items[].description	string	商品描述。
items[].marketplace	string	商户账户提供方或商品所在交易平台。
items[].marketplace_url	string	商品在交易平台上的页面 URL。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

jobs 工作职位结果

字段	类型	说明
title	string	职位模块标题。
url	string	职位结果 URL。
items	array	职位列表，没有时为 null。
items[].type	string	固定为 jobs_element。
items[].title	string	职位标题。
items[].description	string	职位摘要。
items[].author	string	发布或。
items[].job_posted_time	string	职位发布时间。
items[].contract_type	string	合同类型。
items[].salary	string	薪资信息。
items[].url	string	职位 URL。
items[].timestamp	string	结果发布时间，使用 UTC 格式。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

events 活动结果

字段	类型	说明
type	string	固定为 events。
url	string	活动结果 URL。
title	string	活动标题。
items	array	活动列表，没有时为 null。
items[].type	string	固定为 events_element。
items[].title	string	活动标题。
items[].snippet	string	活动摘要。
items[].url	string	活动 URL。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

recipes 菜谱结果

字段	类型	说明
type	string	固定为 recipes。
items	array	菜谱列表，没有时为 null。
items[].type	string	固定为 recipes_element。
items[].title	string	菜谱标题。
items[].url	string	菜谱 URL。
items[].domain	string	来源域名。
items[].source	string	信息来源。
items[].description	string	菜谱摘要。
items[].time	string	菜品准备所需总时间。
items[].rating	object	菜谱评分。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

hotels_pack店结果

字段	类型	说明
type	string	固定为 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	店描述。原字段名保持为 desription。
items[].domain	string	店域名。
items[].rating	object	店评分。
items[].price	object	指定日期的预订价格。
items[].is_paid	boolean	是否为广告。
position、xpath、traffic_cost、rank_group、rank_absolute、etv	-	SERP 通用字段。

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	出现在结果中的搜索词。
time_stamp	string	结果发布时间，使用 UTC 格式。

JSON 数据示例

以下示例展示一条数据库记录的主要结构。记录可能根据和 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": {
      "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",
    "item_types": [
      "organic",
      "paid",
      "images",
      "featured_snippet",
      "people_also_ask"
    ],
    "serp": [
      {
        "type": "organic",
        "domain": "www.example.com",
        "main_domain": "example.com",
        "url": "https://www.example.com/example-page",
        "relative_url": "/example-page",
        "is_malicious": false,
        "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": 9,
        "rank_absolute": 13,
        "etv": 0.291
      }
    ]
  },
  "extra": null
}

> 注意：平台样例中的部分数组存在截断或格式不完整的。接时应以返回的 JSON 文件结构为准，并对可选字段和 null 值进行容处理。

实用场景

• 筛选高搜索量并结合历史趋势制定计划，识别长期稳定或季节性增长的主题，提升的确定性。
• 分析目标的 Bing 自然结果、付费结果和 SERP 特征，评估竞争页面类型与流量获取机会，优化排名策略。
• 监测精选摘要、搜索、用户还问等结果模块，挖掘 FAQ、标题和大纲素材，提高页面覆盖面。
• 比较不同地区和语言下的搜索量与 SERP 排名，支持 SEO、本地化和区域市场决策。
• 结合 rank_absolute、rank_group、etv 与 traffic_cost 评估竞争页面价值，估算自然流量潜力及付费替代成本。