Bing News Search API endpoints
Warning
On October 30, 2020, the Bing Search APIs moved from Azure AI services to Bing Search Services. This documentation is provided for reference only. For updated documentation, see the Bing search API documentation. For instructions on creating new Azure resources for Bing search, see Create a Bing Search resource through the Azure Marketplace.
The News Search API returns news articles, Web pages, images, videos, and entities. Entities contain summary information about a person, place, or topic.
Endpoints
To get news search results using the Bing News Search API, send a GET
request to one of the following endpoints. The headers and URL parameters define further specifications.
News items by search query
GET https://api.cognitive.microsoft.com/bing/v7.0/news/search
Returns news items based on a search query. If the search query is empty, the API will return top news articles from different categories. Send a query by url encoding your search term and appending it to theq=""
parameter. For availability, see Supported countries/regions and markets.
Top news items by category
GET https://api.cognitive.microsoft.com/bing/v7.0/news
Returns the top news items by category. You can specifically request the top business, sports, or entertainment articles using category=business
, category=sports
, or category=entertainment
. The category
parameter can only be used with the /news
URL. There are some formal requirements for specifying categories; refer to category
in the query parameter documentation. Send a query by url encoding your search term and appending it to theq=""
parameter. For availability, see Supported countries/regions and markets.
Trending news topics
GET https://api.cognitive.microsoft.com/bing/v7.0/news/trendingtopics
Returns news topics that are currently trending on social networks. When the /trendingtopics
option is included, Bing search ignores several other parameters, such as freshness
and ?q=""
. For availability, see Supported countries/regions and markets.
Next steps
For details about headers, parameters, market codes, response objects, errors, etc., see the Bing News search API v7 reference.
For complete information about the parameters supported by each endpoint, see the reference pages for each type. For examples of basic requests using the News search API, see Bing News Search Quick-starts.