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 Icon (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.

/buy/marketplace-insights/v1_beta/item_sales/search?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.

/buy/marketplace-insights/v1_beta/item_sales/search?epid=241067840

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.

/buy/marketplace-insights/v1_beta/item_sales/search?gtin=034264484405&category_ids=20625

Retrieve item sales history by category

You can retrieve item sales history by category. The following example returns the sale history for Wristwatches.

/buy/marketplace-insights/v1_beta/item_sales/search?category_ids=31387

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.

/buy/marketplace-insights/v1_beta/item_sales/search?q=shirt&category_ids=137084

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.

/buy/marketplace-insights/v1_beta/item_sales/search?q=iphone&filter=price:[200..800]