Skip to main content

Just getting started with the Marketplace Insights API? See the following documents for details on using this API:

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:

Release Version

Release Date

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.

Error ID

Error Message


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.

GET /buy/marketplace-insights/v1_beta/item_sales/search