Product Metadata API
\xA0

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:

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

Schema Changes - 1.6.0

Announcements - 1.6.0

New Features - 1.6.0

Changed Functionality - 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

Schema Changes - 1.5.0

Announcements - 1.5.0

New Features - 1.5.0

Changed Functionality - 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

Schema Changes - 1.4.0

Announcements - 1.4.0

New Features - 1.4.0

Changed Functionality - 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

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

Schema Changes - 1.3.0

Announcements - 1.3.0

New Features - 1.3.0

Changed Functionality - 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.

NamePart of SchemaType 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

Schema Changes - 1.2.0

Announcements - 1.2.0

New Features - 1.2.0

Changed Functionality - 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

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

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.