Just getting started with the Metadata API? See the following documents for details on using this API:
- Using eBay RESTful APIs
- Selling Integration Guide
- Metadata API overview
Requirements and restrictions - Metadata 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 Metadata API:
| Version | Release Date | Summary of Release |
|---|---|---|
| Version 1.3.0 | 2018-10-15 | Expanded response payload for getReturnPolicies. |
| Version 1.2.0 | 2018-05-15 | One new method added to the marketplace resource: getProductAdoptionPolicies |
| Version 1.1.0 | 2017-06-06 | Five new methods added to the marketplace resource. |
| 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.
Schema changes
This release adds new response fields to the getReturnPolicies method. The response payload now includes the domestic and international complex fields which provide the guidelines for configuring domestic and international return policies for each eBay category. The new domestic and international fields each include the following policy fields:
- policyDescriptionEnabled - A Boolean value that indicates whether or not a seller can populate the returnInstructions field for the associated return policy.
- refundMethods - Defines the allowable refund methods.
- returnMethods - Defines the allowable return methods.
- returnPeriods - Defines the allowable periods of time you can configure for the time the buyer has to return an item.
- returnsAcceptanceEnabled - Defines whether or not a seller accepts returns. While not endorsed by eBay, not accepting a return is a valid return policy.
- returnShippingCostPayers - Defines the allowable values for specifying who pays for the return shipping (
SELLERorBUYER). Note that the return shipping for SNAD-related items must always be paid for by the seller.
Version 1.2.0
The following sections detail the updates that have been made for this release.
New methods
This release adds one new method to marketplace resource:
- For the specified marketplace, retrieves the list of categories that require items to be listed with an ePID value:
GET /marketplace/{marketplaceId}/get_product_adoption_policies
This new method returns a list of leaf categories from the category tree of the specified marketplace. Each node in the response shows the policies that govern whether or not items listed in that category require an ePID value in their item descriptions. If productRequired equals true, then that category is governed by the product-adoption policies and you must include an ePID value in the body of any items you list in that category.
Version 1.1.0
This release introduces five new methods in the new marketplace resource.
API updates
This release contains several new methods that let you retrieve specific listing policies for a specified eBay marketplace. You can filter the response by category IDs:
New methods
- Retrieve automotive-parts-comaptibility policies:
GET /marketplace/{marketplaceId}/get_automotive_parts_compatibility_policies - Retrieve item-condition policies:
GET /marketplace/{marketplaceId}/get_item_condition_policies - Retrieve listing-structure policies:
GET /marketplace/{marketplaceId}/get_listing_structure_policies - Retrieve negotiated-price policies:
GET /marketplace/{marketplaceId}/get_negotiated_price_policies - Retrieve return policies:
GET /marketplace/{marketplaceId}/get_return_policies
Version 1.0.0
This is the initial release of the Metadata API, Version 1.
For a list of the new calls, see the Metadata API Reference.