You use the Marketplace Insights API to retrieve eBay sales history information of items sold on eBay for the last 90 days.
Note: This is a (Limited Release). For information on how to obtain access to this API in production, see the Buy APIs Requirements.
The Marketplace Insights API has the item_sales resource and the use cases it supports are described below.
Retrieve item sales history using search
You can use a keyword search to retrieve item sales history. The following example returns the sale history for Fitbits.
Retrieve item sales history by ePID
The ePID is the eBay product identifier of a product from the eBay product catalog. You can use this URI parameter by itself or as a filter with a keyword search.
The following example returns the sales history for the Nest E Programmable Thermostat in White.
Retrieve item sales history by GTIN
A GTIN is the Global Trade Item Number of the item as defined by http://www.gtin.info. This can be a UPC (Universal Product Code), EAN (European Article Number), or an ISBN (International Standard Book Number) value. You can use this URI parameter by itself or as a filter with a keyword search.
The following example uses a UPC number to return the sales history for Oster Brushed 2-Slice Toaster in Red.
Retrieve item sales history by category
You can retrieve item sales history by category. The following example returns the sale history for Wristwatches.
Or include the category ID with a keyword search to refine the results. The following example returns the sale history of shirts are in the 'Men's Athletic Apparel' category.
Filter item sales history by field values
You can use filters to curate the result set. The following example returns the sales history of iPhones that sold for between $200 and $800 inclusive. See Buy API Field Filters for a list of supported filters.
Note: The filter parameter value must be URL encoded. For better readability, the following example is not encoded.