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).
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.
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.
Please note the following constraints for the Marketplace Insights API.
Note: In addition to the Marketplace Insights API restrictions below, there are also requirements for using the Buy APIs. For more information, see Buy APIs Requirements.
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.
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.
eBay policies and rules
Although the eBay Buy APIs are available for anyone to use in eBay's sandbox environment, use of the APIs in production is restricted. Users must meet standard eligibility requirements, get approvals from eBay support organizations, and sign contracts with eBay and PayPal to access the Buy APIs in production.
See Buy APIs Requirements in the Buying Integration Guide for more information.