The Marketplace Insights API is part of the eBay Buy APIs. It provides the ability to search for sold items on eBay by keyword, GTIN, category, and product and returns the of sales history of those items.
Note: This is a (Limited Release) API available only to select developers approved by business units. For information on how to obtain access to this API in production, see the Buy APIs Requirements.
Technical overview
This API uses the following resource:
- item_sales - Retrieves the sales history of eBay items that have been sold up to 90 days in the past.
Business use cases
The Marketplace Insights API gives you the ability to search for sold items on eBay by keyword, GTIN, ePID (eBay Product ID), and categories and returns the of sales history of those items.
API restrictions
The following are the constraints for the Marketplace Insights API.
Regional/site constraints
For a list of the supported eBay sites for all the Buy APIs, see Buy API Support by Marketplace.
To specify the site, set the X-EBAY-C-MARKETPLACE-ID request header to the site. For example:
X-EBAY-C-MARKETPLACE-ID = EBAY_GB
Item sales history range
The sales history range is up to 90 days in the past.
Category restriction
This API does not support all of the eBay categories. Partner allowed categories need to be vetted by business and then whitelisted for that partner.