| Release Version | Release Date | Description of Release |
|---|---|---|
| 1.5.2 | 2024-08-27 | Added support for the Spanish and French marketplaces |
| 1.5.2 | 2025-11-13 | Added a new field, compatibilityCount, to the getProduct response |
| 1.5.1 | 2024-06-18 | Added support for the Italian marketplace |
| 1.5.0 | 2020-05-18 | Two product metadata methods decommissioned |
| 1.4.0 | 2020-04-01 | Three change request methods decommissioned |
| 1.3.1 | 2019-07-11 | Three change request methods deprecated |
| 1.3.0 | 2018-07-31 | New fields returned in product metadata methods |
| 1.2.0 | 2018-05-24 | Two new calls were added to the Catalog API |
| 1.1.0 | 2018-04-15 | Three new calls were added to the Catalog API |
| 1.0.0 | 2018-02-15 | The initial version of the Catalog API |
1.5.2
The following changes have been made in this release.
Spain (EBAY_ES) and France (EBAY_FR) have been added as supported marketplaces for the Catalog API.
1.5.2
The following changes have been made in this release.
A new field, compatibilityCount, has been added to the getProduct response payload. This field, if applicable, returns the number of distinct motor vehicles that are compatible with the product. This field is only applicable for and will only be returned for Parts & Accessory products on the eBay US Motors marketplace.
1.5.1
The following changes have been made in this release.
Italy (EBAY_IT) has been added as a supported marketplace for the Catalog API.
1.5.0
The following changes have been made in this release.
The two product metadata methods (getProductMetadata and getProductMetadataForCategories) in the Catalog API have been decommissioned. All reference to these methods have been removed from the document set.
1.4.0
The following changes have been made in this release.
The three catalog change request methods (getChangeRequest, getChangeRequests, and createChangeRequest) in the Catalog API have been decommissioned. The three reference documents for these methods have been removed from the document set, and all other documents, including the API Overview page and Selling Integration Guide have been updated to remove all mentions of these three methods.
1.3.1
The following changes have been made in this release.
The three catalog change request methods in the Catalog API are deprecated, and are scheduled to be decommissioned in Q1 of 2020. Below is the expected behavior if a user attempts to use any of these calls:
- getChangeRequest: Currently, this method may still return data for a valid change request ID, but the data will be static, the status will not change, and it will not be possible to make any changes to the change request. At any time, it is possible that all catalog change requests for a user will be removed, and then this method will just trigger this error: The specified change request ID was not found. (error code 75150).
- getChangeRequests: Currently, this method may still return existing change requests for a user, but the data will be static, the statuses will not change, and it will not be possible to make any changes to any of the change requests. At any time, it is possible that all catalog change requests for a user will be removed, and then this method will just return an empty changeRequests array.
- createChangeRequest: This method is no longer supported for any eBay categories and will return this error if used: Change Request is not supported for this product at this moment. (error code 75157)
1.3.0
The following changes have been made in this release.
The getProductMetadata and getProductMetadataForCategories calls were updated to return the following new metadata:
- GTIN fields (ean, isbn, and upc): constraint container will indicate whether the GTIN type is required or not, and if known/applicable, actual GTIN values will be returned under the valueAssociatedWithProduct and/or values fields.
- importance field will be returned under the constraint container for both product aspects and identfiers to indicate the importance of providing that aspect/identifier in a catalog product record. The ImportanceEnum type was added to define the importance values.
Note: The getProductMetadata and getProductMetadataForCategories calls are currently supported in the eBay Sandbox and Production environments for testing purposes. For more information, see Testing Product-Based Shopping Experience APIs in sandbox and Testing Product-Based Shopping Experience APIs in production.
1.2.0
The following changes have been made in this release.
To provide sellers with aspect information they can use to better define their change requests for the eBay catalog, the following two calls were added to the Catalog API:
- getProductMetadata
- getProductMetadataForCategories
Note: These calls are currently supported in the eBay Sandbox and Production environments for testing purposes. For more information, see Testing Product-Based Shopping Experience APIs in sandbox and Testing Product-Based Shopping Experience APIs in production.
1.1.0
The following changes have been made in this release.
To support the ability of sellers to submit feedback and request changes and improvements to the eBay catalog, the following three calls were added to the Catalog API:
- createChangeRequest
- getChangeRequest
- getChangeRequests
Note: These calls are currently supported in the eBay Sandbox and Production environments for testing purposes. For more information, see Testing Product-Based Shopping Experience APIs in sandbox and Testing Product-Based Shopping Experience APIs in production.
1.0.0
The following changes have been made in this release.
This is the initial release of the Catalog API, version 1_beta.0.0.