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