Just getting started with the Marketplace Insights API? See the following documents for details on using this API:
- Using eBay RESTful APIs
- Buying Integration Guide
- Marketplace Insights API Overview
- Marketplace Insights API Reference
See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.
Note: This is a (Limited Release).
The following table lists the Marketplace Insights API releases:
Description of Release
|v1_beta.2.2||2020-12-18||Added error code 100021 to the search method|
|v1_beta.2.1||2020-01-30||postalCode values masked|
|v1_beta.2.0||2018-09-17||Added the lastSoldDate field filter|
|v1_beta.1.0||2018-08-02||Added itemLocation fields|
|v1_beta.0.0||2018-07-17||Initial API beta release|
The error code 100021 was added to the search method. This error message tells you when the offset value of a search query is set above the maximum limit of 10,000, or that the number of listings returned in a search is limited to 10,000.
The maximum number of listings that can be retrieved is 10,000, so your offset value must be less than 10,000. If 10,000 or more listings are matching your search criteria, consider narrowing the scope of your search.
The postalCode values returned under the itemLocation container will be masked to all users.
Added the lastSoldDate field filter. This filter lets you refine the result set to items that were sold within a date range. For example:
Added the itemLocation container. This container returns the postal code and county of the location of the item.
This is the initial BETA release of this API.
There is only one method for the initial release. This method enables you to search for sold items on eBay by keyword, GTIN, categories, and product, and it returns the sales history of those items.