Bing Web Search文档
公共信息
| 参数 | 描述 | 示例 |
|---|---|---|
| basePath | 调用search的基础路径 | https://genaiapi.cloudsway.net/ |
| endpointPath | 调用search的生成的一段随机路径 | LPUqHEAjfonOmohV |
| AccessKey | 调用search的accessKey | RWxxxxxxxx0Gd |
按照上面示例,最终请求bing search接口的路径为
https://genaiapi.cloudsway.net/LPUqHEAjfonOmohV/bing/v7.0/search
或者
https://genaiapi.cloudsway.net/v7.0/search
请求方法
GET
请求路径
-
带endpointPath路径
-
{basePath}/{endpointPath}/bing/v7.0/search
-
能精确定位到唯一的endpoint
-
不带endpointPath路径
-
{basePath}/v7.0/search
-
会自动选择endpoint,如果有多个,会选择第一个
请求header
| 参数 | 必填 | 描述 |
|---|---|---|
| Authorization | 是 | AccessKey Bearer ${AccessKey} Bearer RWxxxxxxxx0Gd |
| Accept | 否 | 默认的媒体类型是 application/json。要指定响应使用 JSON-LD，请将 Accept 头设置为 application/ld+json。 |
| Accept-Language | 否 | 一个以逗号分隔的语言列表，用于用户界面字符串。列表按优先级递减顺序排列。有关更多信息，包括预期格式，请参阅 RFC2616。 此标头和 setLang 查询参数是互斥的——不要同时指定两者。 如果设置此标头，还必须指定 cc 查询参数。为了确定返回结果的市场，Bing 使用列表中找到的第一个支持的语言，并将其与 cc 参数值结合。如果列表中不包含支持的语言，Bing 会找到最接近的支持请求的语言和市场，或者使用聚合市场或默认市场返回结果。要确定 Bing 使用的市场，请参参考BingAPIs-Market 返回标头。 仅在指定多种语言时使用此标头和 cc 查询参数。否则，请使用 mkt 和 setLang 查询参数。 用户界面字符串是用于用户界面中的标签字符串。JSON 响应对象中有少量用户界面字符串。响应对象中任何指向 Bing.com 属性的链接将应用指定的语言。 |
| Pragma | 否 | 默认情况下，Bing 会返回缓存的内容（如果有）。要防止 Bing 返回缓存的内容，请将 Pragma 头设置为 no-cache。 |
| User-Agent | 否 | 发起请求的用户代理。Bing 使用用户代理为移动用户提供优化的体验。虽然是可选的，但建议始终指定此标头。 用户代理应与任何常用浏览器发送的字符串相同。有关用户代理的信息，请参阅 RFC 2616。 几个示例如下 Android — Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) Version/4.0 Mobile Safari/533.1 iPhone — Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423 PC — Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like Gecko iPad — Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53 |
| X-MSEdge-ClientID | 否 | 此标头用于请求和响应。 Bing 使用此标头为用户在 Bing API 调用中提供一致的行为。Bing 经常推出新功能和改进，并使用客户端 ID 作为分配不同测试组的关键。如果您在多次请求中未为同一用户使用相同的客户端 ID，则 Bing 可能会将该用户分配到多个冲突的测试组中。被分配到多个冲突的测试组可能导致用户体验不一致。例如，如果第二次请求与第一次请求的测试分配不同，体验可能会出乎意料。此外，Bing 可以使用客户端 ID 根据该客户端 ID 的搜索历史定制网络结果，为用户提供更丰富的体验。 Bing 还使用此标头通过分析客户端 ID 生成的活动来帮助改进结果排名。相关性改进有助于 Bing API 提供更高质量的结果，从而提高 API 使用者的点击率。 重要提示：虽然是可选的，但应视此标头为必需。为同一终端用户和设备组合在多次请求中保持客户端 ID 一致可以实现：1）API 使用者获得一致的用户体验，2）通过 Bing API 提供的更高质量的结果提高点击率。 以下是适用于此标头的基本使用规则： 每个在设备上使用您的应用程序的用户必须拥有一个唯一的、由 Bing 生成的客户端 ID。 如果您在请求中未包含此标头，Bing 会生成一个 ID 并在 X-MSEdge-ClientID 响应标头中返回。您唯一不应在请求中包含此标头的情况是用户首次在该设备上使用您的应用程序时。 注意：您必须确保此客户端 ID 无法链接到任何经过身份验证的用户帐户信息。 为每个用户在设备上进行的每次 Bing API 请求使用客户端 ID。 持久化客户端 ID。要在浏览器应用程序中持久化 ID，请使用持久性 HTTP cookie 以确保在所有会话中使用该 ID。不要使用会话 cookie。对于其他应用程序（如移动应用程序），请使用设备的持久性存储来持久化 ID。 下次用户在该设备上使用您的应用程序时，获取您持久化的客户端 ID。 注意：Bing 响应可能包含或不包含此标头。如果响应包含此标头，请捕获客户端 ID 并在该设备上为用户的所有后续 Bing 请求中使用它。 注意：如果您包含 X-MSEdge-ClientID，则不得在请求中包含 cookie。 |
| X-MSEdge-ClientIP | 否 | 客户端设备的 IPv4 或 IPv6 地址。IP 地址用于发现用户的位置。Bing 使用位置信息来确定安全搜索行为。 注意：虽然是可选的，但建议始终指定此标头和 X-Search-Location 标头。 不要混淆地址（例如，将最后一个八位字节更改为 0）。混淆地址会导致位置与设备的实际位置相差甚远，这可能导致 Bing 提供错误的结果。 |
| X-Search-Location | 否 | 一个用分号分隔的键/值对列表，描述客户端的地理位置。Bing 使用位置信息来确定安全搜索行为并返回相关的本地内容。键/值对的格式为 lat — 必需。客户端位置的纬度，以度为单位。纬度必须大于或等于 -90.0 并且小于或等于 +90.0。负值表示南纬，正值表示北纬。 long — 必需。客户端位置的经度，以度为单位。经度必须大于或等于 -180.0 并且小于或等于 +180.0。负值表示西经，正值表示东经。 re — 必需。以米为单位的半径，指定坐标的水平精度。传递设备位置服务返回的值。典型值可能是 GPS/Wi-Fi 为 22 米，蜂窝塔三角定位为 380 米，反向 IP 查找为 18,000 米。 ts — 可选。客户端在该位置时的 UTC UNIX 时间戳。（UNIX 时间戳是自 1970 年 1 月 1 日以来的秒数。） head — 可选。客户端的相对前进方向或行进方向。以相对于真北的顺时针方向，从 0 到 360 度指定行进方向。仅在 sp 键非零时指定此键。 sp — 可选。客户端设备的水平速度，以米/秒为单位。 alt — 可选。客户端设备的海拔高度，以米为单位。 are — 可选。以米为单位的半径，指定坐标的垂直精度。仅在指定 alt 键时指定此键。 disp — 可选。用户的地理位置，格式为 disp: 注意事项： 参数的顺序很重要。例如，如果指定 disp 参数，顺序必须是：lat、long、re 和 disp。 如果查询字符串中包含位置，Bing 会忽略此标头。例如，如果此标头设置为 San Francisco，但查询是 restaurants seattle，Bing 会返回位于华盛顿州西雅图的餐馆。 虽然许多键是可选的，但提供的信息越多，位置结果就越准确。 虽然是可选的，但建议始终指定用户的地理位置。如果客户端的 IP 地址不能准确反映用户的物理位置（例如，客户端使用 VPN），提供位置信息尤为重要。为了获得最佳结果，应该包含此标头和 X-Search-ClientIP 标头，但至少应包含此标头。 |
QueryParams
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| answerCount | 否 | Integer | 您希望响应中包含的答案数量。Bing 返回的答案基于排名。例如，如果 Bing 为一个请求返回网页、图片、视频和相关搜索，并且您将此参数设置为 2，则响应将包括网页和图片。 有关将排名答案提升到响应中的信息，请参阅 promote 查询参数。 |
| cc | 否 | String | 一个 2 个字符的国家/地区代码，表示结果来源的国家/地区。 如果设置此参数，您还必须指定 Accept-Language 头。Bing 使用在指定语言中找到的第一个支持的语言，并将其与国家代码结合起来，以确定返回结果的市场。如果语言列表中不包含支持的语言，Bing 会找到最接近的支持请求的语言和市场。或者，Bing 可能会使用聚合市场或默认市场来返回结果。 要知道 Bing 使用的是哪个市场，请在响应中获取 BingAPIs-Market 头。 仅当您指定多种语言时，才使用此查询参数和 Accept-Language 头。否则，您应该使用 mkt 和 setLang 查询参数。 仅当您指定多种语言时，才使用此查询参数和 Accept-Language 头。否则，您应该使用 mkt 和 setLang 查询参数。 此参数和 mkt 查询参数是互斥的——不要同时指定两者。 |
| count | 否 | Short | 返回结果中包含的搜索结果数量。默认值为10，最大值为50。实际返回的数量可能少于请求的数量。 使用此参数和偏移量参数一起分页结果。 例如，如果您的用户界面每页显示10个搜索结果，请将count设置为10，将offset设置为0以获取第一页的结果。对于每个后续页面，将offset增加10（例如，0, 10, 20）。多个页面可能会包含一些重叠的结果。此参数仅影响网页结果，对Bing返回的其他答案（如图片或视频）的数量没有影响。 |
| freshness | 否 | String | 按以下不区分大小写的时间值筛选搜索结果： Day — 返回Bing在过去24小时内发现的网页。 Week — 返回Bing在过去7天内发现的网页。 Month — 返回Bing在过去30天内发现的网页。 要获取Bing在特定时间范围内发现的文章，请指定格式为YYYY-MM-DD..YYYY-MM-DD的日期范围。例如，&freshness=2019-02-01..2019-05-30。要将结果限制为单个日期，请将此参数设置为特定日期。例如，&freshness=2019-02-04。 |
| mkt | 否 | String | 结果来源的市场。通常，mkt是用户发出请求的国家。然而，如果用户不在Bing提供结果的国家，则可能是不同的国家。市场必须采用<语言>-<国家/地区>的形式。例如，en-US。该字符串不区分大小写。 注意：如果已知，强烈建议您始终指定市场。指定市场有助于Bing路由请求并返回适当且最佳的响应。如果您指定的市场不在市场代码列表中，Bing将根据内部映射使用最佳匹配的市场代码，该映射可能会发生变化。 要知道Bing使用的是哪个市场，请在响应中获取BingAPIs-Market头。 此参数与cc查询参数互斥——不要同时指定两个参数。 |
| offset | 否 | Short | 从零开始的偏移量，指示在返回结果之前要跳过的搜索结果数量。默认值为0。偏移量应小于(totalEstimatedMatches - count)。 totalEstimatedMatches为返回值中字段。 使用此参数与count参数一起分页显示结果。例如，如果您的用户界面每页显示10个搜索结果，请将count设置为10，将offset设置为0以获取第一页的结果。对于每个后续页面，将offset增加10（例如，0，10，20）。多个页面可能会包含一些重叠的结果。 |
| promote | 否 | String | 一个以逗号分隔的答案列表，表示您希望响应中包含的答案，无论其排名如何。例如，如果您将answerCount设置为2（即Bing返回排名前两位的答案），但您还希望响应中包含新闻，则可以将promote设置为news。如果排名前两位的答案是网页、图片、视频和相关搜索，响应中将包含网页和图片，因为新闻不是排名答案。但是，如果您将promote设置为video，Bing会将视频答案提升到响应中，并返回网页、图片和视频。 您希望提升的答案不会计入answerCount限制。例如，如果排名答案是新闻、图片和视频，而您将answerCount设置为1，并将promote设置为news，响应中将包含新闻和图片。或者，如果排名答案是视频、图片和新闻，响应中将包含视频和新闻。 以下是可能的值： Computation Entities Images News RelatedSearches SpellSuggestions TimeZone Videos Webpages 注意：仅在您指定answerCount参数时使用。 |
| q | 是 | String | 用户的搜索查询词。该词不能为空。 查询词可以包含Bing高级操作符。例如，要将结果限制在特定域名内，可以使用site:操作符（q=fishing+site:fishing.contoso.com）。请注意，结果可能包含来自其他网站的内容，这取决于在指定网站上找到的相关结果数量。 |
| responseFilter | 否 | String |
一个以逗号分隔的答案列表，用于在响应中包含的答案。如果您未指定此参数，响应将包含所有有相关数据的搜索答案。 以下是可能的过滤值： Computation Entities Images News Places RelatedSearches SpellSuggestions TimeZone Translations Videos Webpages 如果您希望排除特定类型的内容（例如图片）从响应中，可以通过在responseFilter值前添加一个连字符（减号）来排除它们。例如，&responseFilter=-images。 虽然此过滤器可以用于获取单一类型的答案，但您应始终使用特定答案的端点（如果存在），以获得更丰富的结果。例如，要仅接收图片，请将请求发送到其中一个Image Search API端点。 要包含因排名而被排除的答案，请参见promote查询参数。 |
| safeSearch | 否 | String | 用于过滤网页、图片和视频中的成人内容。以下是可能的过滤值： Off — 返回包含成人文本和图片但不包含成人视频的内容。 Moderate — 返回包含成人文本的网页，但不包含成人图片或视频。 Strict — 不返回成人文本、图片或视频。 默认值为Moderate。 注意：对于视频结果，如果safeSearch设置为Off，Bing会忽略它并使用Moderate。 注意：如果请求来自Bing的成人政策要求safeSearch设置为Strict的市场，Bing会忽略safeSearch值并使用Strict。 注意：如果您使用site:查询操作符，无论safeSearch查询参数设置为何值，响应中可能包含成人内容。仅在您了解站点内容并且您的场景支持可能包含成人内容的情况下使用site:。 |
| setLang | 否 | String | 用于用户界面字符串的语言。您可以使用2个字母或4个字母的代码来指定语言。推荐使用4个字母的代码。 如果setlang包含有效的2字母中性文化代码（例如fr）或有效的4字母特定文化代码（例如fr-ca），Bing将加载本地化的字符串。例如，对于fr-ca，Bing将加载fr中性文化代码的字符串。 如果setlang无效（例如zh）或Bing不支持该语言（例如af, af-na），Bing将默认使用en（英语）。 要指定2字母代码，请将此参数设置为ISO 639-1语言代码。 要指定4字母代码，请使用 虽然此参数是可选的，但您应始终指定语言。通常，您将setLang设置为与mkt指定的语言相同，除非用户希望用户界面字符串显示为不同的语言。 此参数和Accept-Language头是互斥的——不要同时指定两者。 用户界面字符串是用作用户界面标签的字符串。在JSON响应对象中有少量用户界面字符串。此外，响应对象中任何指向Bing.com属性的链接都使用指定的语言。 |
| textDecorations | 否 | Boolean | 一个布尔值，用于确定结果中的显示字符串是否应包含装饰标记（例如命中高亮字符）。如果为true，字符串可能包含标记。默认值为false。 要指定是否使用Unicode字符或HTML标签作为标记，请参见textFormat查询参数。 有关命中高亮的更多信息，请参见命中高亮。 |
| textFormat | 否 | String | 用于文本装饰的标记类型（请参见textDecorations查询参数）。 以下是可能的取值： Raw — 使用Unicode字符标记需要特殊格式的内容。Unicode字符范围是E000到E019。例如，Bing使用E000和E001来标记查询词的开始和结束，以进行命中高亮。 HTML — 使用HTML标签标记需要特殊格式的内容。例如，使用标签在显示字符串中高亮显示查询词。 默认值为Raw。 |
返回Headers
| Header | Description |
|---|---|
| BingAPIs-Market | 请求使用的市场。形式为<语言代码>-<国家代码>。例如，en-US。 如果您在请求的mkt查询参数中指定的市场值不在市场代码列表中，则此值可能与您指定的值不同。如果您指定的cc和Accept-Language的值无法协调，也会出现相同的情况。 |
| BingAPIs-TraceId | 包含请求详细信息的日志条目的ID。当发生错误时，请记录此ID。如果您无法确定和解决问题，请将此ID与您提供给支持团队的其他信息一起提交。 |
| Retry-After | 如果您超过每秒（QPS）或每月（QPM）允许的查询次数，响应中将包含此标头。该标头包含您在发送另一个请求之前必须等待的秒数。 |
| X-MSEdge-ClientID | 请参阅请求标头：X-MSEdge-ClientID。 |
返回Body
Attribution
定义内容归属于哪个发布者。
| 名称 | 值 | 类型 |
|---|---|---|
| providerDisplayName | 您用于归属内容的发布者名称。 | String |
| seeMoreUrl | 发布者网站的URL。使用providerDisplayName和此URL创建一个超链接，并在用户界面中显示。 | String |
Computation
定义一个表达式及其答案。
| 名称 | 值 | 类型 |
|---|---|---|
| expression | 数学或转换表达式。如果查询包含单位转换请求（例如，从米到英尺），此字段包含原单位，值字段包含目标单位。如果查询包含数学表达式（例如，2+2），此字段包含表达式，值字段包含答案。请注意，数学表达式可能会被规范化。例如，如果查询是sqrt(4^2+8^2)，规范化的表达式可能是sqrt((4^2)+(8^2))。如果用户的查询是数学问题，并且textDecorations查询参数设置为true，表达式字符串可能包含格式标记。例如，如果用户的查询是log(2)，规范化的表达式包含下标标记。有关更多信息，请参见命中高亮。 | String |
| value | 表达式的答案。 | String |
Error
定义发生的错误。
| 名称 | 值 | 类型 |
|---|---|---|
| code | 标识错误类别的错误代码。有关可能的代码列表，请参见错误代码。 | String |
| message | 错误描述。 | String |
| moreDetails | 提供有关错误的其他信息的描述。 | String |
| parameter | 导致错误的请求查询参数。 | String |
| subCode | 标识错误的错误代码。例如，如果code是InvalidRequest，subCode可能是ParameterInvalid或ParameterInvalidValue。 | String |
| value | 无效的查询参数值。 | String |
ErrorResponse
请求失败时响应中包含的顶层对象。
| 名称 | 值 | 类型 |
|---|---|---|
| _type | 类型提示，设置为ErrorResponse。 | String |
| errors | 描述请求失败原因的错误列表。 | Error[] |
Identifiable
定义资源的身份。
| 名称 | 值 | 类型 |
|---|---|---|
| id | 标识符。 | String |
Image
定义图像。
注意：
由于URL格式和参数可能会在不通知的情况下更改，所有图像URL应按原样使用；不应依赖URL格式或参数。例外情况是那些由调整大小和裁剪缩略图图像讨论的参数和值。
| 名称 | 值 | 类型 |
|---|---|---|
| height | 源图像的高度，以像素为单位。 | Unsigned Short |
| hostPageUrl | 包含图像的网页的URL。此URL和contentUrl可能是相同的URL。 | String |
| name | 包含关于图像的随机信息的可选文本字符串。 | String |
| provider | 图像的来源。数组将包含一个项目。您必须将图像归属给提供者。例如，您可以在光标悬停在图像上时显示提供者的名称，或将图像设置为可点击的链接，指向提供者的网站。 | Organization[] |
| thumbnailUrl | 图像缩略图的URL。有关调整图像大小的信息，请参见调整大小和裁剪缩略图图像。 | String |
| width | 源图像的宽度，以像素为单位。 | Unsigned Short |
License
定义您可以使用内容的许可。
| 名称 | 值 | 类型 |
|---|---|---|
| name | 许可的名称。 | String |
| url | 描述许可的网站的URL。使用名称和URL创建一个超链接。 | String |
LicenseAttribution
定义许可归属的合同规则。
| 名称 | 值 | 类型 |
|---|---|---|
| _type | 类型提示，设置为LicenseAttribution。 | String |
| license | 内容可以使用的许可。 | License |
| licenseNotice | 要显示在目标字段旁边的许可。例如，“文本在CC-BY-SA许可下”。使用许可的名称和URL在许可字段中创建一个指向描述许可详细信息的网站的超链接。然后，将许可通知字符串中的许可名称（例如CC-BY-SA）替换为您刚刚创建的超链接。 | String |
| mustBeCloseToContent | 一个布尔值，确定规则的内容是否必须放置在规则适用的字段附近。如果为true，内容必须放置在附近。如果为false，或此字段不存在，内容可以由调用方自行决定放置。 | Boolean |
| targetPropertyName | 规则适用的字段名称。 | String |
LinkAttribution
定义链接归属的合同规则。
| 名称 | 值 | 类型 |
|---|---|---|
| _type | 类型提示，设置为LinkAttribution。 | String |
| mustBeCloseToContent | 一个布尔值，确定规则的内容是否必须放置在规则适用的字段附近。如果为true，内容必须放置在附近。如果为false，或此字段不存在，内容可以由调用方自行决定放置。 | Boolean |
| targetPropertyName | 规则适用的字段名称。如果未指定目标，归属适用于整个实体，并应在实体展示后立即显示。如果有多个未指定目标的文本和链接归属规则，应将它们连接起来并使用“数据来自：”标签显示。例如，“数据来自<提供者名称1>和<提供者名称2>”。 | String |
| text | 归属文本。 | String |
| url | 提供者网站的URL。使用文本和URL创建一个超链接。 | String |
Malware
定义网页可能在用户点击URL链接时引发潜在问题的通知。
| 名称 | 值 | 类型 |
|---|---|---|
| beSafeRxUrl | 用户可以获取有关安全在线购买处方药更多信息的网页URL。 | String |
| malwareWarningType | 恶意软件通知的类型。可能的值有：NABP — 警告国家药房委员会将此药房列入其不推荐名单。Malware — 警告该网站可能会下载可能损害用户设备的恶意软件。MaliciousPageLink — 警告该网站可能包含可能下载恶意软件的链接，这些软件可能会损害用户设备。Phishing — 警告该网站可能会诱骗用户披露财务、个人或其他敏感信息。 | String |
| warningExplanationUrl | 用户可以获取问题解释的网页URL。对于NABP通知，用户可以使用此链接验证药房。 | String |
| warningLetterUrl | 用户可以获取有关通知更多信息的网页URL。对于NABP通知，用户可以使用此链接查看该委员会不推荐的在线网站列表。 | String |
MediaAttribution
定义媒体归属的合同规则。
| 名称 | 值 | 类型 |
|---|---|---|
| _type | 类型提示，设置为MediaAttribution。 | String |
| mustBeCloseToContent | 一个布尔值，确定规则的内容是否必须放置在规则适用的字段附近。如果为true，内容必须放置在附近。如果为false，或此字段不存在，内容可以由调用方自行决定放置。 | Boolean |
| targetPropertyName | 规则适用的字段名称。 | String |
| url | 用于创建媒体内容超链接的URL。例如，如果目标是图像，您将使用URL使图像可点击。 | String |
MetaTag
定义网页的元数据。
| 名称 | 值 | 类型 |
|---|---|---|
| content | 元数据。 | String |
| name | 元数据的名称。 | String |
Organization
定义发布者。
请注意，发布者可以提供其名称或其网站或两者。
| 名称 | 值 | 类型 |
|---|---|---|
| name | 发布者的名称。 | String |
| url | 发布者网站的URL。请注意，发布者可能不提供网站。 | String |
Query
定义搜索查询。
SpellSuggestions对象使用此对象建议可能代表用户意图的查询字符串。RelatedSearchAnswer也使用它返回其他用户进行的相关查询。
| 名称 | 值 | 类型 |
|---|---|---|
| displayText | 查询词的显示版本。此版本的查询词可能包含突出显示查询字符串中找到的搜索词的特殊字符。字符串仅在查询启用命中高亮时包含高亮字符（请参见textDecorations查询参数）。有关命中高亮的详细信息，请参见命中高亮。 | String |
| text | 查询字符串。使用此字符串作为新搜索请求中的查询词。 | String |
| webSearchUrl | 将用户带到Bing搜索结果页面的URL。仅相关搜索结果包含此字段。 | String |
QueryContext
定义Bing用于请求的查询字符串。
| 名称 | 值 | 类型 |
|---|---|---|
| adultIntent | 布尔值，指示指定的查询是否具有成人意图。如果查询具有成人意图，则值为true。如果为true，并且请求的safeSearch查询参数设置为Strict，响应仅包含新闻结果（如果适用）。 | Boolean |
| alterationOverrideQuery | 用于强制Bing使用原始字符串的查询字符串。例如，如果查询字符串是saling downwind，覆盖查询字符串是+saling downwind。请记住对查询字符串进行编码，结果为%2Bsaling+downwind。仅当原始查询字符串包含拼写错误时，对象才包含此字段。 | String |
| alteredQuery | Bing用于执行查询的查询字符串。如果原始查询字符串包含拼写错误，Bing使用更改后的查询字符串。例如，如果查询字符串是saling downwind，更改后的查询字符串是sailing downwind。仅当原始查询字符串包含拼写错误时，对象才包含此字段。 | String |
| askUserForLocation | 布尔值，指示Bing是否需要用户的位置以提供准确的结果。如果您使用X-MSEdge-ClientIP和X-Search-Location标头指定了用户的位置，则可以忽略此字段。对于需要用户位置以提供准确结果的位置感知查询（例如“今天的天气”或“我附近的餐馆”），此字段设置为true。对于包含位置的位置感知查询（例如“西雅图天气”），此字段设置为false。对于不位置感知的查询（例如“畅销书”），此字段也设置为false。 | Boolean |
| originalQuery | 请求中指定的查询字符串。 | String |
RankingGroup
定义搜索结果组，例如主线。
| 名称 | 值 | 类型 |
|---|---|---|
| items | 要在组中显示的搜索结果项列表。 | RankingItem[] |
RankingItem
定义要显示的搜索结果项。有关如何使用ID的更多信息，请参见排名结果。
| 名称 | 值 | 类型 |
|---|---|---|
| answerType | 包含要显示的项的答案。例如，新闻。使用类型在SearchResponse对象中查找答案。类型是SearchResponse对象中的字段名称。 | String |
| resultIndex | 项在答案中的基于零的索引。如果项不包含此字段，则显示答案中的所有项。例如，显示新闻答案中的所有新闻文章。 | Integer |
| value | 标识要显示的答案或答案项的ID。如果ID标识答案，则显示答案的所有项。 | Identifiable |
RankingResponse
定义搜索结果页面上内容应放置的位置和顺序。
| 名称 | 值 | 类型 |
|---|---|---|
| mainline | 要在搜索结果页面主线部分显示的搜索结果。 | RankingGroup |
| pole | 应给予最显眼处理的搜索结果（例如，显示在主线和侧边栏上方）。 | RankingGroup |
| sidebar | 要在搜索结果页面侧边栏部分显示的搜索结果。 | RankingGroup |
RelatedSearchAnswer
定义其他人进行的相关查询列表。
| 名称 | 值 | 类型 |
|---|---|---|
| id | 唯一标识相关搜索答案的ID。仅当Ranking答案指定应在组中显示所有相关搜索时，对象才包含此字段。有关如何使用ID的更多信息，请参见排名结果。 | String |
| value | 其他人进行的相关查询列表。 | Query[] |
SearchResponse
搜索请求成功时响应的顶层对象。
默认情况下，搜索API包括所有相关答案，除非：
- 查询指定responseFilter查询参数以限制其返回的答案。
- 一个或多个搜索组件不返回结果（例如，查询没有相关的新闻结果）。
- 订阅密钥没有访问搜索组件的权限。
- 如果服务怀疑是拒绝服务攻击，请求成功（HTTP状态代码为200 OK），但响应体为空。
| 名称 | 值 | 类型 |
|---|---|---|
| _type | 类型提示，设置为SearchResponse。 | String |
| computation | 数学表达式或单位转换表达式的答案。 | Computation |
| entities | 与搜索查询相关的实体列表。 | EntityAnswer |
| images | 与搜索查询相关的图像列表。 | ImageAnswer |
| news | 与搜索查询相关的新闻文章列表。 | NewsAnswer |
| places | 与搜索查询相关的地点列表。 | LocalEntityAnswer |
| queryContext | Bing用于请求的查询字符串。 | QueryContext |
| rankingResponse | Bing建议您显示搜索结果的顺序。 | RankingResponse |
| relatedSearches | 其他人进行的相关查询列表。 | RelatedSearchAnswer |
| spellSuggestions | 可能代表用户意图的查询字符串。 | SpellSuggestions |
| timeZone | 一个或多个地理位置的日期和时间。 | TimeZone |
| translations | 将查询字符串中的单词或短语翻译成另一种语言。 | TranslationAnswer |
| videos | 与搜索查询相关的视频列表。 | VideosAnswer |
| webPages | 与搜索查询相关的网页列表。 | WebAnswer |
SpellSuggestions
定义可能代表用户意图的建议查询字符串。
如果Bing确定用户可能打算搜索其他内容，搜索结果包括此响应。例如，如果用户搜索alon brown，Bing可能会确定用户可能打算搜索Alton Brown（基于其他用户过去搜索alon brown的情况）。
| 名称 | 值 | 类型 |
|---|---|---|
| id | 唯一标识拼写建议答案的ID。您在使用排名响应显示拼写建议时使用此字段。有关如何使用ID的更多信息，请参见排名结果。 | String |
| value | 可能代表用户意图的建议查询字符串列表。列表仅包含一个Query对象。 | Query[] |
TextAttribution
定义纯文本归属的合同规则。
| 名称 | 值 | 类型 |
|---|---|---|
| _type | 类型提示，设置为TextAttribution。 | String |
| text | 归属文本。文本归属适用于整个实体，并应在实体展示后立即显示。如果有多个未指定目标的文本或链接归属规则，应将它们连接起来并使用“数据来自：”标签显示。 | String |
TimeZone
定义一个或多个地理位置的日期和时间。
| 名称 | 值 | 类型 |
|---|---|---|
| date | 字符串形式的日期。例如，2019年6月5日星期四。如果用户的查询要求Bing计算日期，答案可能包含此字段。例如，今天起90天。 | String |
| description | 响应的描述。如果查询要求Bing计算一段时间内的天数或周数（例如，一年中的周数或一个月中的天数），或将时间转换为不同的时区（例如，从PST到EST），答案可能包含此字段。 | String |
| otherCityTimes | 地理位置的日期和时间列表。答案包括此字段的查询如美国时区或亚利桑那时区。列表按UTC偏移顺序排列。 | TimeZoneInformation[] |
| primaryCityTime | 查询中指定的地理位置的当前日期和时间（UTC）。如果查询指定了特定的地理位置（例如，一个城市），此对象包含地理位置的名称和当前位置的日期和时间。如果查询指定了一个一般的地理位置，如一个州或国家/地区，此对象包含指定州或国家/地区内主要城市或州的日期和时间。如果位置包含其他时区，otherCityTimes字段包含位于其他时区的城市或州的日期和时间。 | TimeZoneInformation |
| primaryResponse | 满足请求的主要数据。如果查询字符串是2019年有多少周，此字段包含52周零1天。其他查询示例：这个月有多少天和今天的日期。 | String |
| primaryTimeZone | 对象包含地理位置的主要时区。如果一个位置包含多个时区，Bing确定哪个时区是主要时区。答案包括此字段的查询如时区，亚利桑那州的时区，美国时区。 | TimeZoneInformation |
| timeZoneDifference | 时区之间的时间差（以小时为单位）。例如，PST和EST之间有3小时的差异。 | TimeZoneDifference |
TimeZoneDifference
定义时区1和时区2之间的时间差（以小时为单位）。
| 名称 | 值 | 类型 |
|---|---|---|
| location1 | 第一个时区的日期和时间。例如，如果查询是从PST到EST，此字段包含太平洋时区的日期和时间。 | TimeZoneInformation |
| location2 | 第二个时区的日期和时间。例如，如果查询是从PST到EST，此字段包含东部时区的日期和时间。 | TimeZoneInformation |
| text | 表示时区之间时间差的字符串。 | String |
TimeZoneInformation
定义地理位置的日期和时间。
| 名称 | 值 | 类型 |
|---|---|---|
| location | 地理位置的类型。例如，县；城市；城市，州；城市，州，国家/地区；或时区。 | String |
| time | 指定的UTC日期和时间，格式为YYYY-MM-DDThh:mm:ss.ssssssZ。 | String |
| timeZoneName | 地理位置所在的时区名称。如果查询与时区无关，此字符串可能为空。 | String |
| utcOffset | 与UTC的偏移。例如，UTC-7。 | String |
TranslationAnswer
定义查询字符串中单词或短语的翻译。
| 名称 | 值 | 类型 |
|---|---|---|
| attributions | 您在呈现答案时必须归属信息的发布者列表。您必须显示列表中所有发布者的名称作为数据来源。通常，您会在翻译后显示一行提供者。例如，“数据来自：<提供者> | <提供者> |
| contractualRules | 您在显示答案时必须遵守的规则列表。以下合同规则可能适用。有关显示合同规则的信息，请参见数据归属。 | Object[] |
| id | 唯一标识此答案的ID。RankingResponse答案使用此ID指示您应在呈现响应的哪个位置显示此答案。有关如何使用此字段的信息，请参见如何使用排名显示搜索结果。 | String |
| inLanguage | 翻译前的文本语言。使用ISO 639-1两字母语言代码标识语言。例如，es表示西班牙语。 | String |
| originalText | 要翻译的文本。 | String |
| translatedLanguageName | 翻译后的文本语言。使用ISO 639-1两字母语言代码标识语言。例如，en表示英语。 | String |
| translatedText | 翻译后的文本。 | String |
WebAnswer
定义相关网页链接的列表。
| 名称 | 值 | 类型 |
|---|---|---|
| id | 唯一标识网页答案的ID。仅当Ranking答案建议您在组中显示所有网页结果时，对象才包含此字段。有关如何使用ID的信息，请参见排名结果。 | String |
| someResultsRemoved | 一个布尔值，指示响应是否排除了一些结果。如果Bing排除了一些结果，则值为true。 | Boolean |
| totalEstimatedMatches | 与查询相关的网页估计数量。使用此数字与count和offset查询参数一起分页结果。 | Long |
| value | 与查询相关的网页列表。 | WebPage[] |
| webSearchUrl | 请求网页的Bing搜索结果的URL。 | String |
WebPage
定义与查询相关的网页。
| 名称 | 值 | 类型 |
|---|---|---|
| about | 仅供内部使用。 | Object[] |
| dateLastCrawled | Bing最后一次抓取网页的时间。日期格式为YYYY-MM-DDTHH:MM:SS。例如，2015-04-13T05:23:39。 | String |
| datePublished | 网页发布的时间。日期格式为YYYY-MM-DDTHH:MM:SS。例如，2015-04-13T05:23:39。 | String |
| datePublishedDisplayText | datePublished的显示版本。 | String |
| contractualRules | 您在显示答案时必须遵守的规则列表。以下合同规则可能适用。有关显示合同规则的信息，请参见数据归属。 | Object[] |
| deepLinks | Bing在包含此网页的网站中找到的相关内容链接列表。此上下文中的Webpage对象仅包含name和url字段，以及可选的snippet字段。 | WebPage[] |
| displayUrl | 网页的显示URL。此URL仅用于显示目的，并非格式良好。 | String |
| id | 唯一标识网页结果列表中此网页的ID。仅当Ranking答案指定您将网页与其他搜索结果混合时，对象才包含此字段。每个网页包含一个ID，该ID与Ranking答案中的ID匹配。有关更多信息，请参见排名结果。 | String |
| isFamilyFriendly | 一个布尔值，指示网页是否包含成人内容。如果网页不包含成人内容，isFamilyFriendly设置为true。 | Boolean |
| isNavigational | 一个布尔值，指示用户的查询是否经常用于导航到网页域的不同部分。如果用户从该页面导航到网站的其他部分，则值为true。 | Boolean |
| language | 用于标识网页语言的两字母语言代码。例如，en表示英语。 | String |
| malware | 如果Bing认为网页可能在用户点击URL链接时引发潜在问题，您应该在网页链接旁边高可见性地显示通知。 | Malware |
| name | 网页的名称。使用此名称和url创建一个超链接，用户点击时会转到网页。 | String |
| mentions | 仅供内部使用。 | Object |
| searchTags | 网页所有者在网页上指定的搜索标签列表。API仅返回已索引的搜索标签。MetaTag对象的name字段包含已索引的搜索标签。搜索标签以search.*开头（例如，search.assetId）。content字段包含标签的值。 | MetaTag[] |
| snippet | 描述网页内容的文本片段。 | String |
| url | 网页的URL。使用此URL和name创建一个超链接，用户点击时会转到网页。 | String |
请求示例
curl --request GET \
--url 'https://genaiapi.cloudsway.net/LPUqHEAjfonOmohV/bing/v7.0/search?q=panda&count=3' \
--header 'Authorization: Bearer RWxxxxxxxx0Gd'
返回值示例
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "panda"
},
"webPages": {
"webSearchUrl": "https://www.bing.com/search?q=panda",
"totalEstimatedMatches": 1960000,
"value": [
{
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.0",
"contractualRules": [
{
"_type": "ContractualRules/LicenseAttribution",
"targetPropertyName": "snippet",
"targetPropertyIndex": 0,
"mustBeCloseToContent": true,
"license": {
"name": "CC-BY-SA",
"url": "http://creativecommons.org/licenses/by-sa/3.0/"
},
"licenseNotice": "CC-BY-SA 授權涵蓋下的文字"
}
],
"name": "Giant panda - Wikipedia",
"url": "https://en.wikipedia.org/wiki/Giant_panda",
"thumbnailUrl": "https://www.bing.com/th?id=OIP.-W8Tpf_Hda-PZJG5uXLc6AHaE8&w=80&h=80&c=1&pid=5.1",
"isFamilyFriendly": true,
"displayUrl": "https://en.wikipedia.org/wiki/Giant_panda",
"snippet": "The giant panda (Ailuropoda melanoleuca), also known as the panda bear or simply panda, is a bear species endemic to China. It is characterised by its white coat with black patches around the eyes, ears, legs and shoulders.",
"dateLastCrawled": "2024-09-08T23:18:00.0000000Z",
"primaryImageOfPage": {
"thumbnailUrl": "https://www.bing.com/th?id=OIP.-W8Tpf_Hda-PZJG5uXLc6AHaE8&w=80&h=80&c=1&pid=5.1",
"width": 80,
"height": 80,
"sourceWidth": 474,
"sourceHeight": 316,
"imageId": "OIP.-W8Tpf_Hda-PZJG5uXLc6AHaE8"
},
"cachedPageUrl": "http://cc.bingj.com/cache.aspx?q=panda&d=4974328491678709&mkt=zh-HK&setlang=zh-HK&w=x8M1vIgEoVzWEBrTFEYdvTA1UJoJoCAO",
"language": "en",
"isNavigational": false,
"noCache": false,
"siteName": "Wikipedia"
},
{
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.1",
"name": "大熊貓 - 香港海洋公園",
"url": "https://www.oceanpark.com.hk/tc/education-conservation/conservation/animal-and-plant-guide/giant-panda",
"thumbnailUrl": "https://www.bing.com/th?id=OIP.8WHKey_w0GD7M4cW6Eb86gAAAA&w=80&h=80&c=1&pid=5.1",
"isFamilyFriendly": true,
"displayUrl": "https://www.oceanpark.com.hk/.../conservation/animal-and-plant-guide/giant-panda",
"snippet": "瀕危野生動植物種國際貿易公約： 附錄一. 中國國家一級保護野生動物. 現時全中國的野生大熊貓少於1,900隻。. 大熊貓的棲息地因人類活動而被分割開來，令牠們難以遷往其他竹林尋找食物或交配對象，加上牠們的繁殖期十分短暫，令大熊貓的保育工作更加困難。.",
"deepLinks": [
{
"name": "简体",
"url": "https://www.oceanpark.com.hk/sc/education-conservation/conservation/animal-and-plant-guide/giant-panda"
},
{
"name": "Giant Panda",
"url": "https://www.oceanpark.com.hk/kr/education-conservation/conservation/animal-and-plant-guide/giant-panda"
},
{
"name": "大熊貓之旅",
"url": "https://www.oceanpark.com.hk/tc/experience/attractions/attractions/giant-panda-adventure%20%20"
},
{
"name": "En",
"url": "https://www.oceanpark.com.hk/en/education-conservation/conservation/animal-and-plant-guide/giant-panda"
}
],
"dateLastCrawled": "2024-09-09T10:04:00.0000000Z",
"primaryImageOfPage": {
"thumbnailUrl": "https://www.bing.com/th?id=OIP.8WHKey_w0GD7M4cW6Eb86gAAAA&w=80&h=80&c=1&pid=5.1",
"width": 80,
"height": 80,
"sourceWidth": 460,
"sourceHeight": 302,
"imageId": "OIP.8WHKey_w0GD7M4cW6Eb86gAAAA"
},
"cachedPageUrl": "http://cc.bingj.com/cache.aspx?q=panda&d=4599545352300543&mkt=zh-HK&setlang=zh-HK&w=ryPSd2eIaFAroaenUk8IArATxpmfoPSt",
"language": "zh_cht",
"isNavigational": false,
"noCache": false,
"siteName": "Ocean Park Hong Kong"
},
{
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.2",
"name": "【#港產大熊貓BB】新生 BB 生活照初公開 ‼️... - 香港海洋公園 Ocean Park Hong Kong - Facebook",
"url": "https://www.facebook.com/hkoceanpark/posts/894113106087242/",
"isFamilyFriendly": true,
"displayUrl": "https://www.facebook.com/hkoceanpark/posts/894113106087242",
"snippet": "其實每隻大熊貓嘅誕生都可以話係奇跡 大熊貓一向以難於繁殖見稱，而隨著年齡增長，大熊貓成功生 BB 嘅機會就更加細。. 加上大熊貓懷孕，係十分難以檢測，公園獸醫團隊同熊貓中心嘅專家，喺 8 月 11 日透過超聲波掃描檢查，確認盈盈懷孕 團隊每分每秒都 ...",
"dateLastCrawled": "2024-09-09T10:03:00.0000000Z",
"language": "zh_cht",
"isNavigational": false,
"noCache": true,
"siteName": "Facebook"
}
]
},
"entities": {
"value": [
{
"id": "https://api.bing.microsoft.com/api/v7/#Entities.0",
"contractualRules": [
{
"_type": "ContractualRules/LicenseAttribution",
"targetPropertyName": "description",
"mustBeCloseToContent": true,
"license": {
"name": "CC-BY-SA",
"url": "http://creativecommons.org/licenses/by-sa/3.0/"
},
"licenseNotice": "Text under CC-BY-SA license"
},
{
"_type": "ContractualRules/LinkAttribution",
"targetPropertyName": "description",
"mustBeCloseToContent": true,
"text": "維基百科",
"url": "https://zh.wikipedia.org/zh-tw/%E5%A4%A7%E7%86%8A%E7%8C%AB"
},
{
"_type": "ContractualRules/MediaAttribution",
"targetPropertyName": "image",
"mustBeCloseToContent": true,
"url": "https://zh.wikipedia.org/zh-tw/%E5%A4%A7%E7%86%8A%E7%8C%AB"
}
],
"webSearchUrl": "https://www.bing.com/entityexplore?q=%E5%A4%A7%E8%B2%93%E7%86%8A&filters=sid:%226f1dc7ad-6594-06f4-7523-30cf2b2c2e0e%22&elv=AXXfrEiqqD9r3GuelwApuloQczcEGETddLRj8*r*p8UaK92Gw2NlF8rLGBFz8GryLMcmwnYvUAKyFk2S64fHhfnxoi!CDPVANzyxPaBcDcjy",
"name": "大貓熊",
"image": {
"name": "大貓熊",
"thumbnailUrl": "http://www.bing.com/th?id=OSK.a547ea59330cd40cfa8782b005efae48&w=110&h=75&c=7",
"provider": [
{
"_type": "Organization",
"url": "https://zh.wikipedia.org/zh-tw/%E5%A4%A7%E7%86%8A%E7%8C%AB"
}
],
"hostPageUrl": "https://upload.wikimedia.org/wikipedia/commons/8/8d/Lightmatter_panda.jpg",
"width": 110,
"height": 75,
"sourceWidth": 720,
"sourceHeight": 480
},
"description": "大貓熊，屬於食肉目熊科的一種哺乳動物，體色為黑白兩色。是中國特有物種，現存的主要棲息地是中國中西部四川盆地周邊的山區和陝西南部的秦嶺地區。全世界野生大貓熊現存大約有2,060頭。2016年末，世界自然保護聯盟將大貓熊的受威脅等級從「瀕危級」降為「易危級」。 2021年中華人民共和國國務院發表《中國的生物多樣性保護》白皮書稱，野外大貓熊數量從40年前的1,114隻增加到了1,864隻，將大貓熊受威脅程度從「瀕危」降為「易危」。為中國大陸國寶。大貓熊被譽為生物界的活化石。",
"entityPresentationInfo": {
"entityScenario": "DominantEntity",
"entityTypeHints": [
"Generic"
],
"entityTypeDisplayHint": "中國特有的一種珍稀哺乳動物"
},
"bingId": "6f1dc7ad-6594-06f4-7523-30cf2b2c2e0e"
}
]
},
"images": {
"id": "https://api.bing.microsoft.com/api/v7/#Images",
"readLink": "https://api.bing.microsoft.com/api/v7/images/search?q=panda&qpvt=panda",
"webSearchUrl": "https://www.bing.com/images/search?q=panda&qpvt=panda",
"isFamilyFriendly": true,
"value": [
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=53D46D9D096420D267EF71E40432B0DFB3DFD6B7&FORM=IQFRBA",
"name": "Giant Panda Cub Born at Smithsonian’s National Zoo | Smithsonian's ...",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.GDRvk3Egfh6SrD4a-6LPuAHaDt&pid=Api",
"datePublished": "2020-08-22T01:02:00.0000000Z",
"contentUrl": "https://nationalzoo.si.edu/sites/default/files/newsroom/649a1243-cropped.jpg",
"hostPageUrl": "https://nationalzoo.si.edu/news/giant-panda-cub-born-smithsonians-national-zoo-0",
"contentSize": "1528120 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://nationalzoo.si.edu/news/giant-panda-cub-born-smithsonians-national-zoo-0",
"width": 4819,
"height": 2410,
"thumbnail": {
"width": 474,
"height": 237
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=F6B18891FB31C9DFF60209CC172A9D9141B9B69A&FORM=IQFRBA",
"name": "Giant Panda Breeding Update - Adelaide Zoo",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.F5E8Za6eMVC73i21H_Q0HAHaE8&pid=Api",
"datePublished": "2016-03-20T06:59:00.0000000Z",
"contentUrl": "http://www.adelaidezoo.com.au/wp-content/uploads/sites/2/2016/03/Fu-Ni-7.jpg",
"hostPageUrl": "http://www.adelaidezoo.com.au/giant-panda-breeding-update/",
"contentSize": "354521 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://www.adelaidezoo.com.au/giant-panda-breeding-update/",
"width": 4896,
"height": 3264,
"thumbnail": {
"width": 474,
"height": 316
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=98F4786F15EB4ADBBBA44639FA03503C77AE1E15&FORM=IQFRBA",
"name": "pandas.jpg?1389887044",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.neVhJ6MDvR4V2HcPiIi7sAHaE9&pid=Api",
"datePublished": "2015-05-27T22:39:00.0000000Z",
"contentUrl": "http://assets.worldwildlife.org/photos/6147/images/original/pandas.jpg?1389887044",
"hostPageUrl": "https://www.worldwildlife.org/stories/what-do-pandas-eat-and-other-giant-panda-facts",
"contentSize": "1009889 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.worldwildlife.org/stories/what-do-pandas-eat-and-other-giant-panda-facts",
"width": 4031,
"height": 2696,
"thumbnail": {
"width": 474,
"height": 317
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=3E81F5355CCF44556A92930E37F8AACBA8D3BA16&FORM=IQFRBA",
"name": "Panda | Lovely & Sweet Wild Animal Fact & Pictures | WildLife Of World",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.vL4-z2iMTtquIWCPfuRelQHaI2&pid=Api",
"datePublished": "2013-06-17T12:00:00.0000000Z",
"contentUrl": "http://3.bp.blogspot.com/-o9xfn0a_xJ8/Ub6_InF-sgI/AAAAAAAAHUw/qrR0a5PlCw8/s1600/Panda-Lovely-Wild-Animal.jpg",
"hostPageUrl": "http://wildlife-animalz.blogspot.com/2013/06/Panda-Basic-Fact-Photos.html",
"contentSize": "296806 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://wildlife-animalz.blogspot.com/2013/06/Panda-Basic-Fact-Photos.html",
"width": 1338,
"height": 1600,
"thumbnail": {
"width": 474,
"height": 566
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=89E230B975918FD55EF608346C2A4D4FCEB275B0&FORM=IQFRBA",
"name": "File:Atlanta Zoo Panda.jpg",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.HjCmctoNAnLY9_YhpFk7KgHaE8&pid=Api",
"datePublished": "2011-11-05T05:14:00.0000000Z",
"contentUrl": "http://upload.wikimedia.org/wikipedia/commons/0/0e/Atlanta_Zoo_Panda.jpg",
"hostPageUrl": "http://commons.wikimedia.org/wiki/File:Atlanta_Zoo_Panda.jpg",
"contentSize": "1971814 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://commons.wikimedia.org/wiki/File:Atlanta_Zoo_Panda.jpg",
"width": 2025,
"height": 1350,
"thumbnail": {
"width": 474,
"height": 316
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=972E2CF5CD6E1DF4E802C3B4EF51AA3568FC500D&FORM=IQFRBA",
"name": "Adotta un Panda Rosso o un Panda gigante | Ohga!",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.MUPz7Ar79ejriFojX8plkAHaE8&pid=Api",
"datePublished": "2019-01-14T10:15:00.0000000Z",
"contentUrl": "https://static.ohga.it/wp-content/uploads/sites/24/2018/08/istock-177841009.jpg",
"hostPageUrl": "https://www.ohga.it/adotta-un-panda-gigante-e-perche-no-anche-un-panda-rosso/",
"contentSize": "1117369 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.ohga.it/adotta-un-panda-gigante-e-perche-no-anche-un-panda-rosso/",
"width": 3863,
"height": 2578,
"thumbnail": {
"width": 474,
"height": 316
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=8CB3D929710A95EA11D2875E745DD1330B88D28A&FORM=IQFRBA",
"name": "How Many Giant Pandas Are Left in the World? | Reader's Digest",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.uAKe2xrSgIXyG7CCkyQwMgHaHa&pid=Api",
"datePublished": "2020-03-02T16:51:00.0000000Z",
"contentUrl": "https://www.rd.com/wp-content/uploads/2020/03/GettyImages-1060486568-1024x1024.jpg",
"hostPageUrl": "https://www.rd.com/article/how-many-giant-pandas-are-left-in-the-world/",
"contentSize": "144929 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.rd.com/article/how-many-giant-pandas-are-left-in-the-world/",
"width": 1024,
"height": 1024,
"thumbnail": {
"width": 474,
"height": 474
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=83580FCB30A61E4A6291CAB53F88A5C83E4CC3F1&FORM=IQFRBA",
"name": "Wild Giant Pandas Making a Comeback in China",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.lzIWqMamocJ3B7f_l0RKEwHaFq&pid=Api",
"datePublished": "2015-03-01T08:32:00.0000000Z",
"contentUrl": "http://static.artfcity.com/wp-content/uploads/2013/10/Cute-Panda-Bears-animals-34916401-1455-1114.jpg",
"hostPageUrl": "http://defence.pk/threads/wild-giant-pandas-making-a-comeback-in-china.361977/",
"contentSize": "113197 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://defence.pk/threads/wild-giant-pandas-making-a-comeback-in-china.361977/",
"width": 1455,
"height": 1114,
"thumbnail": {
"width": 474,
"height": 362
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=7ACA9B219123D8C9D351B524F7DA1BA1DA5E3A04&FORM=IQFRBA",
"name": "Giant panda - Wikipedia",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.zU1EAaoQ6RILN0Wbc7pS3AHaFd&pid=Api",
"datePublished": "2010-11-01T20:59:00.0000000Z",
"contentUrl": "https://upload.wikimedia.org/wikipedia/commons/thumb/0/0f/Grosser_Panda.JPG/1200px-Grosser_Panda.JPG",
"hostPageUrl": "https://en.wikipedia.org/wiki/Giant_panda",
"contentSize": "244288 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://en.wikipedia.org/wiki/Giant_panda",
"width": 1200,
"height": 885,
"thumbnail": {
"width": 474,
"height": 349
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=A51B0DD82FFB627B2D2BDE0D23BE7809A7A7278F&FORM=IQFRBA",
"name": "Giant Pandas | Live Science",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.Jqh6ZeJ0hkH7dpRZGEGPvwAAAA&pid=Api",
"datePublished": "2012-04-12T00:12:00.0000000Z",
"contentUrl": "https://cdn.mos.cms.futurecdn.net/3n8tRry6fYg7sNyhFDPQwR.jpg",
"hostPageUrl": "https://www.livescience.com/27335-giant-pandas.html",
"contentSize": "991851 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.livescience.com/27335-giant-pandas.html",
"width": 474,
"height": 297,
"thumbnail": {
"width": 474,
"height": 297
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=C4A59FB2A0E084C1433F532B4C40445113B3FC90&FORM=IQFRBA",
"name": "Giant Panda Habitat Facts",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.ZMQ31YanzJf2fEA36v2uewHaEK&pid=Api",
"datePublished": "2023-12-02T15:07:00.0000000Z",
"contentUrl": "https://i.natgeofe.com/k/6a96c3b4-2be1-498f-972e-76a20d973376/3_Baby_Pandas_KIDS_0322_16x9.jpg",
"hostPageUrl": "https://ar.inspiredpencil.com/pictures-2023/giant-panda-habitat-facts",
"contentSize": "783514 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://ar.inspiredpencil.com/pictures-2023/giant-panda-habitat-facts",
"width": 3072,
"height": 1728,
"thumbnail": {
"width": 474,
"height": 266
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=D22AF338068876920BEA4E1C223129594277CB99&FORM=IQFRBA",
"name": "Giant Panda | San Diego Zoo Animals & Plants",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.aaXM1SJ6Ie-YS4v7eGN4PgHaEK&pid=Api",
"datePublished": "2018-12-19T02:04:00.0000000Z",
"contentUrl": "https://animals.sandiegozoo.org/sites/default/files/2016-09/animals_hero_panda.jpg",
"hostPageUrl": "https://animals.sandiegozoo.org/animals/giant-panda?qt-animals_page_content_tabs=2",
"contentSize": "482550 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://animals.sandiegozoo.org/animals/giant-panda?qt-animals_page_content_tabs=2",
"width": 1920,
"height": 1080,
"thumbnail": {
"width": 474,
"height": 266
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=106B31B85D3F372A0A28B3320DA3CB89633081C3&FORM=IQFRBA",
"name": "Premium Photo | Cute little baby panda bear giant panda cub",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.gH9sef9nJuw_qYs4fR_IHgHaHa&pid=Api",
"datePublished": "2022-11-27T02:15:00.0000000Z",
"contentUrl": "https://img.freepik.com/premium-photo/cute-little-baby-panda-bear-giant-panda-cub_691560-1717.jpg?w=1380",
"hostPageUrl": "https://www.freepik.com/premium-photo/cute-little-baby-panda-bear-giant-panda-cub_31932432.htm",
"contentSize": "325536 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.freepik.com/premium-photo/cute-little-baby-panda-bear-giant-panda-cub_31932432.htm",
"width": 1380,
"height": 1380,
"thumbnail": {
"width": 474,
"height": 474
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=28EA67D30C29A433C29B75281912430D21456B45&FORM=IQFRBA",
"name": "File:Giant Panda Eating.jpg",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.SKGhn-eVgfbEWK5fen1Z3AHaE8&pid=Api",
"datePublished": "2014-12-27T12:00:00.0000000Z",
"contentUrl": "http://upload.wikimedia.org/wikipedia/commons/8/8d/Giant_Panda_Eating.jpg",
"hostPageUrl": "http://commons.wikimedia.org/wiki/File:Giant_Panda_Eating.jpg",
"contentSize": "1966224 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://commons.wikimedia.org/wiki/File:Giant_Panda_Eating.jpg",
"width": 2400,
"height": 1600,
"thumbnail": {
"width": 474,
"height": 316
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=A47CB2A2793932446CA97AB31B213CDC32DED375&FORM=IQFRBA",
"name": "File:Giant Panda Tai Shan.JPG - Wikipedia",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.mD2pb3Gvv7eWtHLhIkRlgAHaFj&pid=Api",
"datePublished": "2011-10-16T15:16:00.0000000Z",
"contentUrl": "http://upload.wikimedia.org/wikipedia/commons/8/82/Giant_Panda_Tai_Shan.JPG",
"hostPageUrl": "http://en.wikipedia.org/wiki/File:Giant_Panda_Tai_Shan.JPG",
"contentSize": "3307582 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://en.wikipedia.org/wiki/File:Giant_Panda_Tai_Shan.JPG",
"width": 3456,
"height": 2592,
"thumbnail": {
"width": 474,
"height": 355
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=4E663718BA548F0E236CFD530490C7E7F2063EBA&FORM=IQFRBA",
"name": "Giant Panda | San Diego Zoo Animals & Plants",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.-8YoH6b2SPcCwGsb6iiBywHaLH&pid=Api",
"datePublished": "2011-04-18T13:07:00.0000000Z",
"contentUrl": "https://animals.sandiegozoo.org/sites/default/files/2016-09/T11_0235_033_3.jpg",
"hostPageUrl": "https://animals.sandiegozoo.org/animals/giant-panda",
"contentSize": "138753 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://animals.sandiegozoo.org/animals/giant-panda",
"width": 666,
"height": 1000,
"thumbnail": {
"width": 474,
"height": 711
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=1E86DAE01BECF9B4C1B5618015216B6F04E55EB8&FORM=IQFRBA",
"name": "Panda Gigante | Zoo Aquarium Madrid",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.SNKjYb9m--P_T1vzfHqLuQHaFj&pid=Api",
"datePublished": "2015-05-21T19:48:00.0000000Z",
"contentUrl": "https://www.zoomadrid.com/content/dam/zoo/images/animals/panda-gigante/Oso-panda-gigante-Zoo-Madrid-5.jpg",
"hostPageUrl": "https://www.zoomadrid.com/animales-y-continentes/animales/panda-gigante",
"contentSize": "157187 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.zoomadrid.com/animales-y-continentes/animales/panda-gigante",
"width": 800,
"height": 600,
"thumbnail": {
"width": 474,
"height": 355
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=F85B306AF2F0883AA80FC2AFEBB9A69982B3A787&FORM=IQFRBA",
"name": "PANDA HABITAT",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.niFV2vNHS5lDd3Cbdd7orAHaE7&pid=Api",
"datePublished": "2014-06-01T08:39:00.0000000Z",
"contentUrl": "http://1.bp.blogspot.com/-i6-Gy40Vc4Y/USSs82bjtYI/AAAAAAAAACA/5T76xdzmDxs/s1600/panda_yunzi_baiyun.jpg",
"hostPageUrl": "http://pandahabitat.blogspot.com/",
"contentSize": "298751 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://pandahabitat.blogspot.com/",
"width": 1600,
"height": 1066,
"thumbnail": {
"width": 474,
"height": 315
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=649803C0255D99010887AB5AF2C5AD5F09BE707D&FORM=IQFRBA",
"name": "Panda-monium",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.QVDVjrn3CJG06JtbmLV6agHaE8&pid=Api",
"datePublished": "2011-01-17T10:50:00.0000000Z",
"contentUrl": "http://wasteawarebusiness.files.wordpress.com/2011/01/giant-panda-cub-china4.jpg",
"hostPageUrl": "http://wasteawarebusiness.wordpress.com/2011/01/17/panda-monium/",
"contentSize": "240197 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "http://wasteawarebusiness.wordpress.com/2011/01/17/panda-monium/",
"width": 1728,
"height": 1152,
"thumbnail": {
"width": 474,
"height": 316
}
},
{
"webSearchUrl": "https://www.bing.com/images/search?q=panda&id=7906B6883EEE23614F649120BB7AA43B9BE97EC4&FORM=IQFRBA",
"name": "Giant panda | Facts, Habitat, Population, & Diet | Britannica",
"thumbnailUrl": "https://tse1.mm.bing.net/th?id=OIP.bihNt9swAciic9zwv8XYfgAAAA&pid=Api",
"datePublished": "2019-10-06T13:21:00.0000000Z",
"contentUrl": "https://cdn.britannica.com/80/150980-050-84B9202C/Giant-panda-cub-branch.jpg",
"hostPageUrl": "https://www.britannica.com/animal/giant-panda",
"contentSize": "51603 B",
"encodingFormat": "jpeg",
"hostPageDisplayUrl": "https://www.britannica.com/animal/giant-panda",
"width": 474,
"height": 315,
"thumbnail": {
"width": 474,
"height": 315
}
}
]
},
"relatedSearches": {
"id": "https://api.bing.microsoft.com/api/v7/#RelatedSearches",
"value": [
{
"text": "different types of panda",
"displayText": "different types of panda",
"webSearchUrl": "https://www.bing.com/search?q=different+types+of+panda"
},
{
"text": "foodpanda website",
"displayText": "foodpanda website",
"webSearchUrl": "https://www.bing.com/search?q=foodpanda+website"
},
{
"text": "pandafood",
"displayText": "pandafood",
"webSearchUrl": "https://www.bing.com/search?q=pandafood"
},
{
"text": "pandamart",
"displayText": "pandamart",
"webSearchUrl": "https://www.bing.com/search?q=pandamart"
},
{
"text": "麥當勞 外送",
"displayText": "麥當勞 外送",
"webSearchUrl": "https://www.bing.com/search?q=%E9%BA%A5%E7%95%B6%E5%8B%9E+%E5%A4%96%E9%80%81"
},
{
"text": "foodpanda 中文",
"displayText": "foodpanda 中文",
"webSearchUrl": "https://www.bing.com/search?q=foodpanda+%E4%B8%AD%E6%96%87"
},
{
"text": "panda營養品",
"displayText": "panda營養品",
"webSearchUrl": "https://www.bing.com/search?q=panda%E7%87%9F%E9%A4%8A%E5%93%81"
},
{
"text": "panda後台",
"displayText": "panda後台",
"webSearchUrl": "https://www.bing.com/search?q=panda%E5%BE%8C%E5%8F%B0"
}
]
},
"rankingResponse": {
"mainline": {
"items": [
{
"answerType": "WebPages",
"resultIndex": 0,
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.0"
}
},
{
"answerType": "WebPages",
"resultIndex": 1,
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.1"
}
},
{
"answerType": "Images",
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#Images"
}
},
{
"answerType": "WebPages",
"resultIndex": 2,
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.2"
}
}
]
},
"sidebar": {
"items": [
{
"answerType": "Entities",
"resultIndex": 0,
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#Entities.0"
}
},
{
"answerType": "RelatedSearches",
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#RelatedSearches"
}
}
]
}
}
}
MarketCode
| Country/Region | Language | Market code |
|---|---|---|
| Argentina | Spanish | es-AR |
| Australia | English | en-AU |
| Austria | German | de-AT |
| Belgium | Dutch | nl-BE |
| Belgium | French | fr-BE |
| Brazil | Portuguese | pt-BR |
| Canada | English | en-CA |
| Canada | French | fr-CA |
| Chile | Spanish | es-CL |
| Denmark | Danish | da-DK |
| Finland | Finnish | fi-FI |
| France | French | fr-FR |
| Germany | German | de-DE |
| Hong Kong SAR | Traditional Chinese | zh-HK |
| India | English | en-IN |
| Indonesia | English | en-ID |
| Italy | Italian | it-IT |
| Japan | Japanese | ja-JP |
| Korea | Korean | ko-KR |
| Malaysia | English | en-MY |
| Mexico | Spanish | es-MX |
| Netherlands | Dutch | nl-NL |
| New Zealand | English | en-NZ |
| Norway | Norwegian | no-NO |
| People's republic of China | Chinese | zh-CN |
| Poland | Polish | pl-PL |
| Republic of the Philippines | English | en-PH |
| Russia | Russian | ru-RU |
| South Africa | English | en-ZA |
| Spain | Spanish | es-ES |
| Sweden | Swedish | sv-SE |
| Switzerland | French | fr-CH |
| Switzerland | German | de-CH |
| Taiwan | Traditional Chinese | zh-TW |
| Türkiye | Turkish | tr-TR |
| United Kingdom | English | en-GB |
| United States | English | en-US |
| United States | Spanish | es-US |
国家/地区代码
| Country/Region | Country/Region Code |
|---|---|
| Argentina | AR |
| Australia | AU |
| Austria | AT |
| Belgium | BE |
| Brazil | BR |
| Canada | CA |
| Chile | CL |
| Denmark | DK |
| Finland | FI |
| France | FR |
| Germany | DE |
| Hong Kong SAR | HK |
| India | IN |
| Indonesia | ID |
| Italy | IT |
| Japan | JP |
| Korea | KR |
| Malaysia | MY |
| Mexico | MX |
| Netherlands | NL |
| New Zealand | NZ |
| Norway | NO |
| People's Republic of China | CN |
| Poland | PL |
| Portugal | PT |
| Republic of the Philippines | PH |
| Russia | RU |
| Saudi Arabia | SA |
| South Africa | ZA |
| Spain | ES |
| Sweden | SE |
| Switzerland | CH |
| Taiwan | TW |
| Türkiye | TR |
| United Kingdom | GB |
| United States | US |
支持语言
| Supported Languages | Language Code |
|---|---|
| Arabic | ar |
| Basque | eu |
| Bengali | bn |
| Bulgarian | bg |
| Catalan | ca |
| Chinese (Simplified) | zh-hans |
| Chinese (Traditional) | zh-hant |
| Croatian | hr |
| Czech | cs |
| Danish | da |
| Dutch | nl |
| English | en |
| English-United Kingdom | en-gb |
| Estonian | et |
| Finnish | fi |
| French | fr |
| Galician | gl |
| German | de |
| Gujarati | gu |
| Hebrew | he |
| Hindi | hi |
| Hungarian | hu |
| Icelandic | is |
| Italian | it |
| Japanese | jp |
| Kannada | kn |
| Korean | ko |
| Latvian | lv |
| Lithuanian | lt |
| Malay | ms |
| Malayalam | ml |
| Marathi | mr |
| Norwegian (Bokmål) | nb |
| Polish | pl |
| Portuguese (Brazil) | pt-br |
| Portuguese (Portugal) | pt-pt |
| Punjabi | pa |
| Romanian | ro |
| Russian | ru |
| Serbian (Cyrylic) | sr |
| Slovak | sk |
| Slovenian | sl |
| Spanish | es |
| Swedish | sv |
| Tamil | ta |
| Telugu | te |
| Thai | th |
| Turkish | tr |
| Ukrainian | uk |
| Vietnamese | vi |
Bing高级操作符
| 符号 | 函数 |
|---|---|
| + | 查找包含前面带有 + 符号的所有术语的网页。 还允许包括通常被忽略的术语。 |
| " " | 查找短语中的确切字词。 |
| () | 查找或排除包含一组单词的网页。 |
| AND 或 & | 查找包含所有术语或短语的网页。 |
| NOT 或 – | 排除包含术语或短语的网页。 |
| OR 或 | | 查找包含任一术语或短语的网页。 |
注意:
-
默认情况下，所有搜索都是 AND 搜索。
-
必须将 NOT 和 OR 运算符大写。 否则，必应将忽略它们作为停止字词，这些字词和数字是常见的单词和数字，为加快全文搜索速度而省略。
-
停止字词和除本主题中介绍的符号外的所有标点符号将被忽略，除非它们由引号括起或前面带有 + 符号。
-
仅前 10 个术语用于获取搜索结果。
-
以下首选顺序支持术语分组和布尔运算符：
-
由于 OR 是优先级最低的运算符，因此当与搜索中的其他运算符结合使用时，将 OR 词括在括号中。
-
此处介绍的一些特性和功能可能在你的国家/地区不可用。
-
()
-
""
-
NOT – +
-
AND &
-
或 |
Azure Python Sdk兼容示例
- 安装依赖
python -m pip install azure-cognitiveservices-search-websearch
- 初始化Client并调用
需要注意的是要变更认证方式,以及endpoint
# Import required modules.
from azure.cognitiveservices.search.websearch import WebSearchClient
from azure.cognitiveservices.search.websearch.models import SafeSearch
from msrest.authentication import BasicTokenAuthentication
# Replace with your subscription key.
subscription_key = "xxx"
endpoint = "https://genaiapi.cloudsway.net/{endpointPath}"
# Instantiate the client and replace with your endpoint.
auth = BasicTokenAuthentication({'access_token': subscription_key})
client = WebSearchClient(endpoint=endpoint, credentials=auth)
# Make a request. Replace Yosemite if you'd like.
web_data = client.web.search(query="pandas")
print("result:{}", web_data)
Azure Java Sdk兼容示例
以Azure Java Sdk为例
- pom引入Azure Bing Search Sdk依赖
<dependency>
<groupId>com.microsoft.azure</groupId>
<artifactId>azure</artifactId>
<version>1.9.0</version>
</dependency>
<dependency>
<groupId>commons-net</groupId>
<artifactId>commons-net</artifactId>
<version>3.3</version>
</dependency>
<dependency>
<groupId>com.microsoft.azure.cognitiveservices</groupId>
<artifactId>azure-cognitiveservices-websearch</artifactId>
<version>1.0.1</version>
</dependency>
- 初始化Client并调用
需要注意的是要变更认证方式
package com.example.demo.service;
import java.io.IOException;
import com.microsoft.azure.cognitiveservices.search.websearch.BingWebSearchAPI;
import com.microsoft.azure.cognitiveservices.search.websearch.BingWebSearchManager;
import com.microsoft.azure.cognitiveservices.search.websearch.models.SearchResponse;
import com.microsoft.rest.credentials.ServiceClientCredentials;
import okhttp3.Interceptor;
import okhttp3.OkHttpClient.Builder;
import okhttp3.Request;
import okhttp3.Response;
public class BingSearchService {
public static final String KEY = "Bearer {ak}";
public static final String BASE_URL = "https://genaiapi.cloudsway.net/{endpointPath}/bing/v7.0/";
public void bingSearch() {
ServiceClientCredentials serviceClientCredentials = new ServiceClientCredentials() {
@Override
public void applyCredentialsFilter(Builder builder) {
builder.addNetworkInterceptor(new Interceptor() {
@Override
public Response intercept(Chain chain) throws IOException {
Request request = null;
Request original = chain.request();
Request.Builder requestBuilder = original.newBuilder().addHeader("Authorization", KEY);
request = requestBuilder.build();
return chain.proceed(request);
}
});
}
};
BingWebSearchAPI client = BingWebSearchManager.authenticate(BASE_URL, serviceClientCredentials);
SearchResponse webData = client.bingWebs().search()
.withQuery("panda")
.execute();
}
}