Bing News Search API endpoints

  • Article

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.

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.