Product Metadata API Release Notes
You can find links to the Product Metadata API documentation in the top navigation bar. Information about the schema location is in the Schema Location section of the "Making an API Call" topic.
Are you just getting started with the Product Services? The following describes how to join the eBay Developers Program:
- Users Guide -- an introduction to the eBay Product Services
- eBay Developer Documentation Center
- eBay APIs - Quick Start
| Version | Release Date | \xA0 |
|---|---|---|
| 1.6.0 | 2013-03-13 | \xA0 |
| 1.5.0 | \xA0 | |
| 1.4.0 | 2012-03-14 | \xA0 |
| 1.3.0 | 2011-07-20 | \xA0 |
| 1.2.0 | 2010-04-28 | \xA0 |
| 1.1.0 (initial release) | 2010-02-24 | \xA0 |
Version 1.6.0
Index of Changed Calls - 1.6.0
Documentation Changes and Errata - 1.6.0
For a current list of known issues, see API Call Limits page and the Knowledge Base.
Index of Changed Calls - 1.6.0
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
New Calls
Changed Calls
No changed calls in this release.
New Field
There is a new Component field.
Schema Changes - 1.6.0
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
getAdditionalCompatibilitySearchNamesRequest |
Complex type | New |
GetCompatibilitySearchValuesByVehicleCompatibilityBaseRequest |
Complex type | New |
GetMultiValueBasedProductSearchValuesBaseRequest |
Complex type | New |
GetProductSearchValuesBaseRequest |
Complex type | New |
Announcements - 1.6.0
Change Requests
See the System Announcements for bug fixes related to this release.
New Features - 1.6.0
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.6.0.
New Calls to Support Compatibility Properties within Fitment Categories
The getAdditionalCompatibilitySearchNames call retrieves all the component properties within a fitment category of the specified catalog-enabled category. If a category has 'additional compatibility-enabled', use this call to find the property names needed to list the compatibilities. Then you use the getAdditionalCompatibilitySearchValues call with the names from getAdditionalCompatibilitySearchNames to complete the name-value pairs that make up the additional compatibility details that can be added.
Changed Functionality - 1.6.0
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1.6.0
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.6.0 and Changed Functionality - 1.6.0.
None for this release.
Version 1.5.0
Index of Changed Calls - 1.5.0
Documentation Changes and Errata - 1.5.0
For a current list of known issues, see API Call Limits page and the Knowledge Base.
Index of Changed Calls - 1.5.0
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
New Calls
Changed Calls
No changed calls in this release.
Schema Changes - 1.5.0
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
GetMultipleValueBasedProductSearchValuesRequest |
Complex type | New |
MultiValueProperty |
Complex type | New |
ReturnPropertySortOrder |
Complex type | New |
SingleValueProperty |
Complex type | New |
Announcements - 1.5.0
Change Requests
See the System Announcements for bug fixes related to this release.
New Features - 1.5.0
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.5.0.
None for this release.
Support for Finding up to 10 Values
The new getMultiValueBasedCompatibilitySearchValues call retrieves all available values and their dependencies for a given compatibility property or a group of compatibility properties. For a given property a maximum of 10 values can be passed in the request. The getMultiValueBasedProductSearchValues call retrieves all available values and their dependencies for a given product property or a group of properties (of the product catalog) for up to 10 fields.
Changed Functionality - 1.5.0
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1.5.0
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.5.0 and Changed Functionality - 1.5.0.
None for this release.
Version 1.4.0
Index of Changed Calls - 1.4.0
Documentation Changes and Errata - 1.4.0
For a current list of known issues, see API Call Limits page and the Knowledge Base.
Index of Changed Calls - 1.4.0
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
New Calls
- getCompatibilitySearchNamesByVehicleCompatibility
- getCompatibilitySearchValuesByVehicleCompatibility
Changed Calls
No changed calls in this release.
Schema Changes - 1.4.0
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
GetCompatibilitySearchNamesByVehicleCompatibilityRequest |
Complex type | New |
GetCompatibilitySearchValuesByVehicleCompatibilityRequest |
Complex type | New |
Announcements - 1.4.0
Change Requests
See the System Announcements for bug fixes related to this release.
New Features - 1.4.0
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.4.0.
None for this release.
Support for Compatibility by Vehicle
You can now retrieve compatibility name-value pair for specific vehicles use the getCompatibilitySearchNamesByVehicleCompatibility and getCompatibilitySearchValuesByVehicleCompatibility calls. The getCompatibilitySearchNamesByVehicleCompatibility call retrieves all properties within a fitment-enabled vehicle catalog. The getCompatibilitySearchValuesByVehicleCompatibility retrieves property values for up to 10 fields.
Changed Functionality - 1.4.0
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1.4.0
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.4.0 and Changed Functionality - 1.4.0.
None for this release.
Version 1.3.0
Index of Changed Calls - 1.3.0
Documentation Changes and Errata - 1.3.0
For a current list of known issues, see API Call Limits page and the Knowledge Base.
Index of Changed Calls - 1.3.0
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
New Calls
Changed Calls
No changed calls in this release.
Schema Changes - 1.3.0
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
BaseRequest |
Complex type | New |
BaseResponse |
Complex type | New |
ExtensionType |
Complex type | New |
GroupProperties |
Complex type | New |
GroupProperty |
Complex type | New |
MediaTypeSpecificInformation |
Complex type | New |
NumericTypeSpecificInformation |
Complex type | New |
ProductMetadata |
Complex type | New |
ProductMetadataBulkRequest |
Complex type | New |
ProductMetadataBulkResponse |
Complex type | New |
ProductMetadataRequest |
Complex type | New |
ProductMetadataResponse |
Complex type | New |
PropertyMetadata |
Complex type | New |
StringTypeSpecificInformation |
Complex type | New |
Tag |
Complex type | New |
TypeSpecificInformation |
Complex type | New |
URITypeSpecificInformation |
Complex type | New |
Announcements - 1.3.0
Change Requests
See the System Announcements for bug fixes related to this release.
New Features - 1.3.0
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.3.0.
New Call to Support Product Creation
The getProductMetadataBulk call retrieves product metadata for the specified category. Use this metadata to build an addProducts (Product API) call for submitting a product for inclusion in the eBay catalog corresponding to the category.
See Product Creation for more information about when you should add a product to an eBay catalog, and how to do it.
Changed Functionality - 1.3.0
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1.3.0
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.3.0 and Changed Functionality - 1.3.0.
None for this release.
Version 1.2.0
Index of Changed Calls - 1.2.0
Documentation Changes and Errata - 1.2.0
For a current list of known issues, see API Call Limits page and the Knowledge Base.
Index of Changed Calls - 1.2.0
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
New Calls
No new calls in this release.
Changed Calls
- getCompatibilitySearchValues
- getCompatibilitySearchValuesBulk
- getProductSearchValues
- getProductSearchValuesBulk
Schema Changes - 1.2.0
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
GetCompatibilitySearchValuesBulkRequest |
Complex type | Removed (unused) |
SortPriority |
Enumerated type | Removed (unused) |
SortOrder |
Complex type | New |
GetProductSearchValuesBaseRequest.sortOrder |
Element | New |
Announcements - 1.2.0
Changes to Message Part Names
Message part names in the WSDL have been renamed from "parameters" to "params" to correct a problem for .NET developers. This fix allows .NET users to add web references in Visual Studio without errors.
Change Requests
See the System Announcements for bug fixes related to this release.
New Features - 1.2.0
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.2.0.
Sort Capability for Property Values
For calls that return property values, you can now sort the properties in the response. You can sort by any of the searchable properties, such as Year, Make, or Model. If no sort order is specified then values are sorted in ascending order.
To specify sort order, indicate the property (sortOrder.propertyName) sort on, such as Make or Model, and the order (sortOrder.order), Ascending or Descending:
<sortOrder> <order>Descending</order> <propertyName>Model</propertyName> </sortOrder>
Changed Functionality - 1.2.0
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1.2.0
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.2.0 and Changed Functionality - 1.2.0.
None for this release.
Version 1.1.0
This is the first release of the eBay Product Metadata API.
Note: Watch these release notes for changes.
For a current list of known issues, see eBay Shopping, Product Metadata and Merchandising API Production System Announcements and the Knowledge Base.
Index of Changed Calls - 1.1.0
These calls are included in the initial release of the eBay Product Metadata API.
New Calls
- getCompatibilitySearchDataVersion
- getCompatibilitySearchNames
- getCompatibilitySearchValues
- getCompatibilitySearchValuesBulk
- getProductSearchDataVersion
- getProductSearchNames
- getProductSearchValues
- getProductSearchValuesBulk
Schema Changes - 1.1.0
Monitor upcoming release notes for descriptions of purpose and use for new or modified schema.
Announcements - 1.1.0
Change Requests
See the eBay Shopping, Product Metadata and Merchandising API Production System Announcements for bug fixes related to this release.
New Features - 1.1.0
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.1.0.
None for this release.
Changed Functionality - 1.1.0
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1.1.0
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.1.0 and Changed Functionality - 1.1.0.
None for this release.