Chapter 1: Using the REST API 15
Retrieve Product Information with GetProducts
Version 3.7
GetSearchResultsExpress in the REST API has many similarities to GetSearchResultsExpress in the
unified schema. A link to more information, which show more ways to use this call, is in the
following topic. This unified schema topic contains detailed information about the call and can
answer many questions:
http://developer.ebay.com/DevZone/XML/docs/WebHelp/
index.htm?context=eBay_XML_API&topic=ExpressSearch
The following sample shows how to use the Query parameter to search by keywords:
http://rest.api.ebay.com/
restapi?CallName=GetSearchResultsExpress&RequestToken=UserToken&RequestUserId=UserName&Que
ry=garmin+gps&EntriesPerPage=3&Version=491
The following sample shows how to retrieve all the departments, aisles, and product types that are
currently on Express. To make sure all the details are retrieved,
HistogramDetails is set to Fine.
http://rest.api.ebay.com/
restapi?CallName=GetSearchResultsExpress&RequestToken=UserToken&RequestUserId=UserName&Vers
ion=491&DepartmentName=Express&HistogramDetails=Fine&HistogramSort=Alphabetical
The following sample shows how to sort items in the GetSearchResultsExpress response by the
lowest total cost, which includes the current fixed price plus default shipping costs. This request sets
ItemSort to LowestTotalCost and it includes a postal code in PostalCode to enable Express to calculate
shipping costs. This example also shows the effects of setting
HistogramDetails, ProductDetails, and
ItemDetails to Fine.
http://rest.api.ebay.com/
restapi?CallName=GetSearchResultsExpress&RequestToken=UserToken&RequestUserId=UserName&Que
ry=garmin+gps+receiver&EntriesPerPage=3&Version=491&DepartmentName=Consumer_Electronics&Hi
stogramDetails=Fine&HistogramSort=Alphabetical&ProductDetails=Fine&ProductSort=LowestPrice&Item
Details=Fine&ItemSort=LowestTotalCost&PostalCode=95125
The following sample shows how to search for a book with Pre-filled Item Information by using an
ISBN as an external product ID. You can also use this approach to search for items by UPC. Please
note that the ExternalProductID query only finds items that were listed with Pre-filled Item
Information. That is, if the seller did not pre-fill an item’s Item Specifics based on a stock catalog
product, this query will not find the item.
http://rest.api.ebay.com/
restapi?CallName=GetSearchResultsExpress&RequestToken=UserToken&RequestUserId=UserName&Entri
esPerPage=3&Version=491&ExternalProductIDType=ISBN&ExternalProductIDValue=0439425239&Produc
tDetails=Fine&ItemDetails=Fine&Condition=All
Retrieve Product Information with GetProducts
You can use GetProducts to retrieve a variety of product information. GetProducts retrieves more
buying guide details (as available) than GetSearchResults (described in “Find Items with
GetSearchResults” on page 9).
