/ 
WWW-Search-Ebay-2.197
River stage zero No dependents
/ WWW::Search::Ebay

NAME

WWW::Search::Ebay - backend for searching www.ebay.com

SYNOPSIS

use WWW::Search;
my $oSearch = new WWW::Search('Ebay');
my $sQuery = WWW::Search::escape_query("C-10 carded Yakface");
$oSearch->native_query($sQuery);
while (my $oResult = $oSearch->next_result())
  { print $oResult->url, "\n"; }

DESCRIPTION

This class is a Ebay specialization of WWW::Search. It handles making and interpreting Ebay searches http://www.ebay.com.

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

NOTES

The search is done against CURRENT running AUCTIONS only. (NOT completed auctions, NOT eBay Stores items, NOT Buy-It-Now only items.) (If you want to search completed auctions, use the WWW::Search::Ebay::Completed module.) (If you want to search eBay Stores, use the WWW::Search::Ebay::Stores module.)

The query is applied to TITLES only.

The results are ordered youngest auctions first (reverse order of auction listing date).

In the resulting WWW::Search::Result objects, the description field consists of a human-readable combination (joined with semicolon-space) of the Item Number; number of bids; and high bid amount (or starting bid amount).

In the resulting WWW::Search::Result objects, the bid_count field contains the number of bids as an integer.

In the resulting WWW::Search::Result objects, the bid_amount field is a string containing the high bid or starting bid as a human-readable monetary value in seller-native units, e.g. "$14.95" or "GBP 6.00".

OPTIONS

Search descriptions

To search titles and descriptions, add 'srchdesc'=>'y' to the query options:

$oSearch->native_query($sQuery, { srchdesc => 'y' } );
Search one category

To restrict your search to a particular eBay category, find out eBay's ID number for the category and add 'sacategory'=>123 to the query options:

$oSearch->native_query($sQuery, { sacategory => 48995 } );

If you send a single asterisk or a single space as the query string, the results will be ALL the auctions in that category.

SEE ALSO

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

BUGS

Please tell the author if you find any!

AUTHOR

WWW::Search::Ebay was written by Martin Thurn (mthurn@cpan.org).

WWW::Search::Ebay 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.