marketing APIv1_beta.1.0

Marketing API Release Notes

Just getting started with the Browse 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.

The API release history

The following table lists the Marketing API releases:

Release Version

Release Date

Description of Release

v1_beta.1.0 2017-09-26 Added the getAlsoBoughtProducts and getAlsoViewedProducts calls
v1_beta.0.0 2017-06-07 Initial API beta release


The following changes were made to the Marketing API.

Added two calls

The following calls were added to the Marketing API. These call let you show products that were 'also viewed' or 'also bought', which encourages up-selling and cross-selling.

  • getAlsoBoughtProducts - This call returns products that were also purchased when people purchased the product specified in the request. For details, see the getAlsoBoughtProducts reference page.
  • getAlsoViewedProducts - This call returns products that were also viewed when people viewed the product specified in the request. For details, see the getAlsoViewedProducts reference page.

Announcement - June 2017

Availability of OpenAPI Specification

This release of the Marketing API includes Beta version downloadable JSON and YAML formats of the API contract that comply with version 2.0 of the OpenAPI Specification. The OpenAPI Specification is a widely adopted standard for describing RESTful APIs. The eBay API specification files can facilitate your development process through the ability to generate client code in numerous languages, using the Swagger-Codegen tools, as well as the ability to easily view and test the API via the Swagger UI projects. Development of the OpenAPI Specification is overseen by the Open API Initiative, an open source collaborative project of the Linux Foundation.

Note: If you want to use the Swagger editing tool for viewing and testing, we advise you use the version of the editor that is compatible with 2.0 OpenAPI specifications:

Read the eBay API documentation for comprehensive API details, including allowed values, constraints, method-specific error messages, and implementation details.

File download     Download Marketing API JSON specification (beta)

File download     Download Marketing API YAML specification (beta)


This is the initial BETA release of this API.

New calls

There is only one call for the initial release.

GET /merchandised_product