使用 Bing 新聞搜尋 API 來搜尋新聞
警告
在 2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋 服務。 本文件僅供參考之用。 如需更新的文件，請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
Bing 影像搜尋 API 可讓您輕鬆地將 Bing 的認知新聞搜尋功能整合到應用程式中。
Bing 新聞搜尋 API 主要用於尋找及傳回相關的新聞文章，同時也提供多個在 Web 上智慧擷取重點新聞的功能。
建議和使用搜尋字詞
若您提供使用者可在其中輸入其搜尋字詞的搜尋方塊，請使用 Bing 自動建議 API 來改善使用經驗。 API 會根據部分搜尋字詞傳回建議的查詢字串，作為使用者類型。
在使用者輸入其搜尋字詞之後，URL 會先將此字詞編碼，再設定 q 查詢參數。 例如，如果使用者輸入 sailing dinghies，請將 q 設定為 sailing+dinghies 或 sailing%20dinghies。
取得一般新聞
若要從 Web 取得與使用者的搜尋字詞相關聯的一般新聞文章，請傳送下列 GET 要求：
GET https://api.cognitive.microsoft.com/bing/v7.0/news/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
如果這是您第一次呼叫任何的 Bing API，請勿包含用戶端識別碼標頭。 如果您先前已呼叫 Bing API 且 Bing 傳回了使用者和裝置組合的用戶端識別碼，則只要包含用戶端識別碼。
若要從特定網域取得新聞，請使用 site: 查詢運算子。
GET https://api.cognitive.microsoft.com/bing/v7.0/news/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1
以下 JSON 範例顯示前一個查詢的回應。 由於 Bing 搜尋 API 的使用和顯示需求，您必須以回應中提供的順序來顯示每則新聞文章。 如果該文章有叢集化文章，您應該指出有相關文章存在，並在要求時加以顯示。
{
"_type" : "News",
"readLink" : "https:\/\/api.cognitive.microsoft.com\/bing\/v5\/news\/search?q=sailing+dinghies",
"totalEstimatedMatches" : 88400,
"value" : [{
"name" : "Sailing Vies for Four Trophies",
"url" : "http:\/\/www.bing.com\/cr?IG=CCE2F06CA750455891FE99A72...",
"image" : {
"thumbnail" : {
"contentUrl" : "https:\/\/www.bing.com\/th?id=ON.9C23AA5...",
"width" : 650,
"height" : 341
}
},
"description" : "College Rankings, presented by Zim...",
"provider" : [{
"_type" : "Organization",
"name" : "contoso.com"
}],
"datePublished" : "2017-04-14T15:28:00"
},
...
{
"name" : "Fabrikam Sailing Club to host Mirror Dinghy...",
"url" : "http:\/\/www.bing.com\/cr?IG=CCE2F06CA750455891F...",
"image" : {
"thumbnail" : {
"contentUrl" : "https:\/\/www.bing.com\/th?id=ON.36...",
"width" : 448,
"height" : 300
}
},
"description" : "The sailing club that trained Olympian Ben...",
"provider" : [{
"_type" : "Organization",
"name" : "Contoso"
}],
"datePublished" : "2017-04-04T11:02:00",
"category" : "Sports"
}]
}
新聞 (英文) 回答中會列出 Bing 認為與查詢相關的新聞文章清單。 totalEstimatedMatches 欄位包含可供檢視的文章數目估計值。 如需有關如何逐頁瀏覽文章的資訊，請參閱逐頁瀏覽新聞。
清單中每篇新聞文章 (英文) 都包含文章的名稱、描述以及文章在主機網站上的 URL。 如果文章包含影像，物件就會包含影像的縮圖。 使用 name 和 url 來建立帶領使用者前往主機網站上新聞文章的超連結。 如果文章包含影像，請讓影像也可以使用 url 進行點按。 請務必使用 provider 來歸類文章。
如果 Bing 可以判斷出新聞文章的類別，文章就會包含 category 欄位。
取得今天的熱門新聞
若要取得今天的熱門新聞文章，您可以如同以前一樣傳送相同的一般新聞要求，讓 q 參數取消設定。
GET https://api.cognitive.microsoft.com/bing/v7.0/news/search?q=&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
取得熱門新聞的回應幾乎和取得一般新聞相同。 不過，news 回應中不會包含 totalEstimatedMatches 欄位，原因是其會有一組固定數目的結果。 不同新聞週期可能會有不同的熱門新聞數目。 請務必使用 provider 欄位來歸類文章。
取得各類別的新聞
若要依類別取得新聞文章 (例如，運動或娛樂的熱門新聞)，請對 Bing 傳送下列 GET 要求：
GET https://api.cognitive.microsoft.com/bing/v7.0/news?category=sports&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
使用 category 查詢參數來指定要取得的文章類別。 如需可指定的新聞類別清單，請參閱依市場的新聞類別。
依類別取得新聞的回應幾乎和取得一般新聞相同。 不過，文章全都來自指定的類別。
取得頭條新聞
若要要求頭條新聞文章，並取得所有新聞類別的文章，請對 Bing 傳送下列 GET 要求：
GET https://api.cognitive.microsoft.com/bing/v7.0/news?mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
請勿包含 category 查詢參數。
取得頭條新聞的回應和取得今天的熱門新聞相同。 如果文章是頭條新聞文章，其 headline 欄位會設定為 true。
根據預設，回應中最多會包含 12 篇頭條新聞文章。 若要變更所傳回的頭條新聞文章數目，請指定 headlineCount 查詢參數。 回應中也會針對每個新聞類別包含最多四個非頭條新聞文章。
回應會將叢集視為一篇文章。 因為叢集中可能有數篇文章，回應可能會包含超過 12 篇頭條新聞文章，以及每個類別超過四篇的非頭條新聞文章。
取得熱門新聞
若要取得社交網路上引領趨勢的新聞主題，請對 Bing 傳送下列 GET 要求：
GET https://api.cognitive.microsoft.com/bing/v7.0/news/trendingtopics?mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
X-MSAPI-UserState: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
注意
趨勢主題僅適用於 en-US 和 zh-CN 市場。
下列 JSON 是先前要求的回應。 每個趨勢新聞文章都包含相關的影像、最新消息旗標，以及 Bing 搜尋針對該文章所傳回結果的 URL。 請在 webSearchUrl 欄位中使用該 URL，以讓使用者前往 Bing 搜尋結果頁面。 或者，請使用查詢文字來呼叫 Web 搜尋 API 來自己顯示結果。
{
"_type" : "TrendingTopics",
"value" : [{
"name" : "Canada pot measure",
"image" : {
"url" : "https:\/\/www.bing.com\/th?id=OPN.RTNews_hHD...",
"provider" : [{
"_type" : "Organization",
"name" : "Contoso Images"
}]
},
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=070292D8CEDD...",
"isBreakingNews" : false,
"query" : {
"text" : "Canada marijuana"
}
},
{
"name" : "Down on Vegas move",
"image" : {
"url" : "https:\/\/www.bing.com\/th?id=OPN.RTNews_Bfbmg8h...",
"provider" : [{
"_type" : "Organization",
"name" : "Contoso"
}]
},
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=070292D8CEDD...",
"isBreakingNews" : false,
"query" : {
"text" : "Marcus Appel Las Vegas"
}
},
...
]
}
取得相關新聞
如果有其他與新聞文章相關的文章，新聞文章內可能會包括 clusteredArticles 欄位。 下列內容顯示具有叢集化文章的文章。
{
"name" : "Playoffs 2017: Betting lines, point spreads...",
"url" : "http:\/\/www.bing.com\/cr?IG=4B7056CEC271408997D115...",
"image" : {
"thumbnail" : {
"contentUrl" : "https:\/\/www.bing.com\/th?id=ON.D7B1...",
"width" : 700,
"height" : 393
}
},
"description" : "April 14, 2017 3:37pm EDT April 14, 2017 3:34pm...",
"provider" : [{
"_type" : "Organization",
"name" : "Contoso"
}],
"datePublished" : "2017-04-14T19:43:00",
"category" : "Sports",
"clusteredArticles" : [{
"name" : "Playoffs 2017: Betting odds, favorites to win...",
"url" : "http:\/\/www.bing.com\/cr?IG=4B7056CEC271408997D1159E...",
"description" : "April 14, 2017 3:30pm EDT April 14, 2017 3:27pm...",
"provider" : [{
"_type" : "Organization",
"name" : "Contoso"
}],
"datePublished" : "2017-04-14T19:37:00",
"category" : "Sports"
}]
},
節流要求
服務與您的訂用帳戶類型將決定您所適用的每秒查詢數目 (QPS)。 請確定您的應用程式包含維持在配額範圍內所需的邏輯。 如果已達到或超過 QPS 限制，要求即會失敗，且會傳回 HTTP 429 狀態碼。 回應會包含 Retry-After 標頭，指出您必須等待多久後才能傳送另一個要求。
拒絕服務與節流
服務會區分拒絕服務 (DoS) 攻擊和 QPS 違規。 如果服務懷疑有 DoS 攻擊，要求仍會成功 (HTTP 狀態碼為「200 確定」)， 但回應本文會是空的。