You are here: Sell APIs > Marketing API > Release Notes

Marketing API release notes

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

The API release history

The following table lists the releases for the Marketing API:


Release Date

Summary of Release

Version 1.1.0


Added a new call that returns the listings in a Promotion.

Added a container to support creating Promotions using a set of rules.

Version 1.0.0


Initial release of Version 1.

Version 1.1.0

The following sections detail the updates that have been made for this release.

New calls

There was one new call added.

Get Listings in Specific Promotion - GET /promotion/{promotion_id}/get_listing_set
This call returns a paged collection of the listings associated with the specified promotion.

Schema changes

The following sections detail any changes to the schema.

Added new inventoryCriterion.ruleCriteria container

The inventoryCriterion.ruleCriteria container was added to the Create Item Promotion, Get Item Promotion, and Update Item Promotion calls. This enables sellers to select the listings for a promotion by setting rules, such as a list eBay or seller's Store category Ids, constrained by min and max price, brand, or condition. You can explicitly exclude up to 100 eBay listing Ids or seller inventory reference Ids (also known as SKU or custom label). A promotion can have multiple rules.

Documentation changes and errata

More examples were added to the Promotion Code Examples document and it was retitled to Specifying Discounts. Note the filename and location were not changed.

Version 1.0.0

This is the initial release of the Marketing API, Version 1.

For a list of the new calls, see the Marketing API Reference.