marketplace insights APIv1_beta.1.0.0

Marketplace Insights API Overview

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).

Topics

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

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.

Regional/site constraints

The Marketplace Insights API is supported on the following eBay sites:

  • EBAY-AU - Australia (ebay.com/au)
  • EBAY-CA - Canada (English) (ebay.ca)
  • EBAY-DE - Germany (ebay.de)
  • EBAY-ES - Spain (ebay.es)
  • EBAY-FR - France (ebay.fr)
  • EBAY-GB - Great Britain (ebay.co.uk)
  • EBAY-IT - Italy (ebay.it)
  • EBAY-US - USA (ebay.com)

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.

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.