Just getting started with the Marketing API? See the following documents for details on using this API:
- Using eBay RESTful APIs
- Marketing section of the Selling Integration Guide
- Marketing API Overview
- Marketing API Reference
Announcements
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 releases for the Marketing API:
|
Version |
Release Date |
Summary of Release |
|---|---|---|
|
2017-05-31 |
Version 1.3.0 contains the following updates:
|
|
|
2017-04-26 |
Added seven new calls that support the new reporting feature for Promoted Listings. |
|
| Version 1.1.0 |
2017-03-07 |
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 |
2016-10-19 |
Initial release of Version 1. |
Version 1.3.0
The following sections detail the updates that have been made for this release.
Added Promotion report call
The Get Promotions Report call was added. This call generates a report for all the seller's RUNNING, PAUSED, or ENDED promotions for the specified eBay marketplace. It summarizes the seller's performance at a promotion level on a given site. You must specify the eBay marketplace and can limit the report by using a search keyword or by specifying the promotion status to include. You can also control the number of promotions returned in the result set.
Changed errors to warnings
In the Create Item Promotion and Update Item Promotion calls the following ERRORS were changed to WARNINGS.
|
Code |
Category |
Nature |
Meaning |
|---|---|---|---|
| 38226 | REQUEST | WARNING | The listing ID must be numeric if you're using listingIds. |
| 38227 | REQUEST | WARNING | The listing ID is invalid. |
| 38263 | REQUEST | WARNING | The SKU or custom label used in inventoryReferenceId exceeds the maximum length, which is {skuLength}. |
| 38272 | BUSINESS | WARNING | This listing is not eligible for a promotion because it's an auction-style listing. |
| 38273 | BUSINESS | WARNING | This listing is not eligible for a promotion because it's a minimum advertised price (MAP) listing. |
| 38274 | BUSINESS | WARNING | You haven't included PayPal as a payment method. In order to make this listing eligible, update it to include PayPal. |
| 38275 | BUSINESS | WARNING | This SKU used in inventoryReferenceId matches an item that is part of a listing with variations. This SKU is only eligible if we add all of the listing variations. To add this listing, use the parent, or main, SKU (custom label). |
| 345112 | REQUEST | WARNING | Invalid Store category. Please refer to API documentation to source allowed values. |
| 345113 | REQUEST | WARNING | Invalid Marketplace Category ID. Please refer to API documentation to source allowed values. |
Added using Taxonomy API information
The list of eBay category IDs is not published, but you can use the Taxonomy API to retrieve the default category tree for a seller's marketplace. The Taxonomy API provides calls that enable the seller to browse or search the category tree hierarchy and select categories to use as criteria for the promotion. See the Taxonomy API.
Version 1.2.0
The following new calls have been added to the Marketing API for Promoted Listings.
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.
getListingSet - 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 createItemPromotion, getItemPromotion, and updateItemPromotion 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.
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.