News SourceType (Bing, Version 2.0)

This SourceType provides:

  • News specific to a topic, such as Entertainment

  • News specific to a location, such as Missoula or Missouri

  • Breaking news (if any) as the first result.

  • Top news stories. To receive top news stories, send a request with the Query parameter without a value - that is, send an empty query. For more information, see the next section.

About News Results

LocationOverride, Category, and SortBy are mutually exclusive. Specifically:

  • If LocationOverride is specified, then Category and SortBy, if specified, are ignored, and LocationOverride is used.

  • If LocationOverride is not specified, and Category is specified, the SortBy, if specified, is ignored, and Category is used.

  • If neither LocationOverride nor Category is specified, and SortBy is specified, then SortBy is used.

The Empty Query Scenario

To view top news stories, send a request with the query parameter empty. (That is, Query=)

Request Parameters

Required Parameters

The following parameters are required for all requests:

Note

To get results from a given SourceType, you must specify it in a SearchRequest.Sources statement.

Optional Parameters

The following optional parameters are applicable to this SourceType.

Note

This parameter is not applicable to the Empty Query Scenario. For more information, see the section of this name in this topic.

Note

This parameter is not applicable to the Empty Query Scenario. For more information, see the section of this name in this topic.

Response Fields

The following response fields are common to all source types:

The following response fields are specific to the News SourceType:

Request and Response Examples

For examples of requests and responses for this SourceType specific to a given protocol, see:

Code Samples

For examples of code that sends a request that specifies this SourceType and parses the response, see News SourceType Code Samples.

See Also

Concepts

API Reference (Bing, Version 2)