如何使用bing search api来进行网页开发

Bing 搜索引擎为微软旗下推出，集网页，图片，视频，新闻等等搜索的结果，使用bing search api的前提是拥有微软账号，微软账号的注册可以使用qq邮箱或者gmail（谷歌旗下的邮箱）进行注册，之后在注册bing的账号，可由微软的账号进行登录，最后进行Microsoft Azure Marketplace账号的注册，这个是为了开发人员使用search api而用到的账号，在绑定银行卡（mastcard或visa）后，可以获得一个key，这个key（密钥）可以调用bing search api的所有产品（bing 网页搜索，bing视频搜索等等）。

有了key之后，我们可以在微软的费用计划表盘中，看到每个月的各个订阅api使用次数，频率，和总的使用费用，bing不会收取前期和后期费用，每个月有1000次免费的调用bing search api的次数。

关于调用search api的费用详情：

Bing Search API v7 定价详情

实例	每秒交易数 (TPS)	特征	所有市场（日本除外）	日本市场¹
自由	3 TPS	必应图片搜索必应新闻搜索必应视频搜索必应视觉搜索必应网页搜索必应实体搜索必应自动建议必应拼写检查	所有市场每月 1,000 次免费交易
S1	250 TPS	必应网页搜索必应图片搜索必应新闻搜索必应视频搜索必应实体搜索必应自动建议* 必应拼写检查* 可选的 Bing 统计加载项	每 1,000 笔交易 7 美元每 25,000 笔交易 7 美元* 每 1,000 笔交易 1 美元	每 1,000 笔交易 20 美元每 25,000 笔交易 20 美元* 每 1,000 笔交易 7 美元
S2	100 TPS	必应网页搜索必应自动建议* 必应拼写检查* 可选的 Bing 统计加载项	每 1,000 笔交易 3 美元每 10,000 笔交易 3 美元* 每 1,000 笔交易 1 美元	每 1,000 笔交易 10 美元每 10,000 笔交易 10 美元* 每 1,000 笔交易 7 美元
S3	100 TPS	必应网页搜索必应图片搜索可选的 Bing 统计加载项	每 1,000 笔交易 4 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 12 美元每 1,000 笔交易 7 美元
S4	100 TPS	必应网页搜索必应视频搜索可选的 Bing 统计加载项	每 1,000 笔交易 4 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 12 美元每 1,000 笔交易 7 美元
S5	100 TPS	必应网页搜索必应新闻搜索可选的 Bing 统计加载项	每 1,000 笔交易 4 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 12 美元每 1,000 笔交易 7 美元
S6	100 TPS	必应网页搜索必应实体搜索可选的 Bing 统计加载项	每 1,000 笔交易 3 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 10 美元每 1,000 笔交易 7 美元
S7	150 TPS	必应网页搜索必应图片搜索必应视频搜索可选的 Bing 统计加载项	每 1,000 笔交易 5 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 14 美元每 1,000 笔交易 7 美元
S8	150 TPS	必应网页搜索必应图片搜索必应新闻搜索必应视频搜索可选的 Bing 统计加载项	每 1,000 笔交易 6 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 16 美元每 1,000 笔交易 7 美元
S9	30 TPS	必应视觉搜索可选的 Bing 统计加载项	每 1,000 笔交易 3 美元每 1,000 笔交易 1 美元	每 1,000 笔交易 10 美元每 1,000 笔交易 7 美元

如果我们目前的需求只使用网页搜索且不需要大量并发的话，建议使用：

S6的这个订阅，100tps/s（每秒大概可完成100次请求api服务），每1000次需要支付3美元（约19.11人民币），每个月还有1000次免费的机会

使用bing search api只需要访问：https://api.bing.microsoft.com/v7.0/search即可

请求简单示例：

Curl -H "Ocp-Apim-Subscription-Key: <yourkeygoeshere>" https://api.bing.microsoft.com/v7.0/search?q=microsoft+devices

请求头可以携带的数据：

用户代理——让 Bing 知道是否需要移动或桌面体验。
X-MSEdge-ClientID — 提供体验的连续性。
X-MSEdge-ClientIP — 为位置感知查询提供用户的位置。
X-Search-Location — 为位置感知查询提供用户的位置。

示例：

curl -H "Ocp-Apim-Subscription-Key: <yourkeygoeshere>" -H "X-MSEdge-ClientID: 00B4230B74496E7A13CC2C1475056FF4" -H "X-MSEdge-ClientIP: 11.22.33.44" -H "X-Search-Location: lat:55;long:-111;re:22" -A "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.65 Safari/537.36" https://api.bing.microsoft.com/v7.0/search?q=microsoft+devices

响应头可携带的数据：

BingAPIs-TraceId — 标识日志文件中的请求的 ID。
X-MSEdge-ClientID — 您需要在后续请求中传递以提供体验连续性的 ID。
BingAPIs-Market — Bing 用于请求的市场。

示例：

curl -D - -H "Ocp-Apim-Subscription-Key: <yourkeygoeshere>" https://api.bing.microsoft.com/v7.0/search?q=microsoft+devices

可传入的查询参数：

计数和偏移- 用于分页网页结果。
mkt — 用于指定结果来自的市场，通常是用户发出请求的市场。
safeSearch — 用于指定用户的安全搜索首选项。
textDecorations和textFormat — 用于打开命中突出显示。
新鲜度：上一次网页抓取的时间规定
安全搜索：关，中等，严格
设置语言：用户字符串的语言
文字装饰品：用于确定结果中的显示字符串是否应包含装饰标记，例如命中突出显示字符。如果为true，则字符串可能包含标记。默认值为false。要指定是使用 Unicode 字符还是 HTML 标记作为标记

文本格式：用于文本修饰的标记类型（请参阅textDecorations查询参数）。

以下是可能的值：

Raw — 使用 Unicode 字符来标记需要特殊格式的内容。Unicode 字符的范围是 E000 到 E019。例如，Bing 使用 E000 和 E001 来标记查询词的开头和结尾以突出显示。
HTML — 使用 HTML 标签来标记需要特殊格式的内容。例如，使用 <b> 标签来突出显示字符串中的查询词。

默认值为原始。

示例：

curl -H "Ocp-Apim-Subscription-Key: <yourkeygoeshere>" https://api.bing.microsoft.com/v7.0/search?q=microsoft+devices&mkt=en-us&safeSearch=moderate&textdecorations=true&textformat=raw&count=10&offset=0

响应体可返回的结果（json）（拿网页查询api举例，图片查询，视频查询，新闻查询可能在响应里有一些不同，如图片可以定义大小，新闻没有过滤排名等）

Bing search api封装好的响应属性类型有很多，主要包括了我们网页上需要的：

标题名称，部分字段，url，显示url，标签，查询到的总数，分页，深层网页链接，辅助输入，恶意链接警告，时间，时区，要求返回网页数量，过滤排名等等近100种类型的返回。

最主要的是我们要求的返回响应码（code）和信息（message）这里虽然bing自己定义了一些code和message，但是我们一般使用自己项目中的code和message，所以这里不一一例举。

Bing包含的实体类型：

基本实体类型

通用的
人
地方
媒体
组织

放置基类型实体提示

景点
城市
大陆
国家
酒店
房子
当地的商业
地域性
小区域
邻里
其他
兴趣点
邮政编码
广播电台
地区
餐厅
状态
街道地址
次区域
旅游景点
旅行

媒体基类型实体提示

书
电影
电视季
电视节目
电子游戏

事件相关的实体提示

事件

职业相关实体提示

演员
艺术家
律师

教育相关实体提示

学院或大学
学校
专业

其他实体提示

动物
车
药品
食物
产品
运动队

Bing详细教程：https://docs.microsoft.com/en-us/bing/search-apis/bing-web-search/reference/entity-types