NAME

Bing::Search::Source::News - Get news results

SYNOPSIS

 my $source = Bing::Search::Source::News->new;

DESCRIPTION

The News source fetches news articles given various criteria.

There is a special case, the "empty query", where Bing will return the top news stories. Otherwise, there are three options that interact with each other.

From http://msdn.microsoft.com/en-us/library/dd250884.aspx:

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.

METHODS

Make sure to read the previous section with regards to LocationOverride, Category, and SortBy.

Market, Version, Options, and setOptions

See Bing::Search for documentation on these common attributes.

News_Count and News_Offset retain the familiar interaction as well.

The default value for News_Count is 10, with a range of 1 to 15. The sum of News_Count and News_Offset cannot exceed 15. News_Offset must be 0 or greater.

News_LocationOverride

Overrides the location for news. If invalid, the default location is used ("everywhere").

The format is US.<state> and is only valid in the en-US market.

News_Category

Filters results based on a category. Only valid in the en-US market. According to http://msdn.microsoft.com/en-us/library/dd250868.aspx, valid values are:

rt_Business

rt_Entertainment

rt_Health

rt_Politics

rt_Sports

rt_US

rt_World

rt_ScienceAndTechnology

News_SortBy

How to sort the news results. Valid options are Date and Relevance.

AUTHOR

Dave Houston, " dhouston@cpan.org ", 2010

LICENSE

This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.