man WWW::Search::Yahoo::News::Advanced () - class for searching Yahoo! News using the "advanced" interface

NAME

WWW::Search::Yahoo::News::Advanced - class for searching Yahoo! News using the "advanced" interface

SYNOPSIS

  use WWW::Search;
  my $oSearch = new WWW::Search('Yahoo::News::Advanced');
  my $sQuery = WWW::Search::escape_query("George Lucas");
  $oSearch->date_from('2001-05-05');
  $oSearch->date_to(  '2001-07-05');
  $oSearch->native_query($sQuery);
  while (my $oResult = $oSearch->next_result())
    print $oResult->url, "\n";

DESCRIPTION

This class is a Yahoo! News specialization of WWW::Search. It handles making and interpreting searches on Yahoo! News http://search.news.yahoo.com using the Advanced search interface.

This class exports no public interface; all interaction should be done through WWW::Search objects.

NOTES

This backend supports narrowing the search by date-range. Use date_from() and date_to() to set the endpoints of the desired date range. You can use any date format supported by the Date::Manip module.

If either date endpoint is not set explicitly, it will search with an appropriately open-ended date range.

NOTE that Yahoo only keeps the last 90 days worth of news in its index.

ALSO NOTE that Yahoo will return an ERROR if date_from() is set to anything prior to Jan. 1 1999. This backend does NOT check for that.

News.yahoo.com dies if the unescaped query is longer than 485 characters or so. This backend does NOT check for that.

SEE ALSO

To make new back-ends, see WWW::Search.

BUGS

Please tell the maintainer if you find any!

TESTING

There are no tests defined for this module.

AUTHOR

CWWWW::Search::Yahoo::News::Advanced is maintained by Martin Thurn (mthurn@cpan.org).

LEGALESE

THIS SOFTWARE IS PROVIDED AS IS AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

VERSION HISTORY

If it''s not listed here, then it wasn''t a meaningful nor released revision.

2.04, 2002-10-31

overhaul for new webpage format

2.01, 2001-07-16

First public release.