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


Added seven new calls that support the new reporting feature for Promoted Listings.

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

The following new calls have been added to the Marketing API for Promoted Listings.

Get Specific Report
GET /ad_report/{report_id}
Downloads the specified report.
Get Metadata For All Reports
GET /ad_report_metadata
Retrieves the metadata for all reports.
Get Metadata For a Report Type
GET /ad_report_metadata/{report_type}
Retrieves the metadata for a specific report.
Create Report Task
POST /ad_report_task
Creates a report task. A report task contains the definition of a report and is what generates the report based on that definition. You retrieve a report task using the Get Specific Report Task or the Get Report Tasks calls.
Delete Specific Report Task
DELETE /ad_report_task/{report_task_id}
Deletes the specified report task.
Get Report Tasks
GET /ad_report_task
Retrieves the report tasks based on filters.
Get Specific Report Task
GET /ad_report_task/{report_task_id}
Retrieves the criteria, such as dimensions, metrics, listing, etc., and the generation rules, such as starting and ending date, for the specified report task.

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.