eBay Shopping API

Shopping API Release Notes

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 Shopping API? See the following resources for more information:

Release Version Release Date Description of Release
1293 2023-01-13 CharityNumber deprecated
1247 2022-02-25 HitCount deprecated
1199 2021-03-26 Max length for Feedback comment fields increased
1157 2020-06-05 Added Support for OAuth Tokens
1145 2020-03-13 Updates to Charity-related documentation
1139 2020-01-31 Postal codes masked in GetSingleItem/GetMultipleItems except to sellers

For older release notes, see the Release Notes archive.

Back to top

Version 1293

Index of Changed Calls - 1293

Schema Changes - 1293

Announcements - 1293

New Features - 1293

Changed Functionality - 1293

Documentation Changes and Errata - 1293

For a current list of known issues, see Site Status Updates or visit the Support page.

Index of Changed Calls - 1293

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 - 1293

Name Part of Schema Type of Change
Item.CharityNumber Field Removed

Announcements - 1293

Change Requests

See the Site Status Updates for bug fixes related to this release.

New Features - 1293

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 - 1293.

None for this release.

Changed Functionality - 1293

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.

CharityNumber no longer returned

The CharityNumber field is no longer returned in GetSingleItem and GetMultipleItems. The CharityNumber field is no longer used to identify a charitable organization. Instead, the CharityID field is used.

Documentation Changes and Errata - 1293

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1293 and Changed Functionality - 1293.

None for this release.

Back to top

Version 1247

Index of Changed Calls - 1247

Schema Changes - 1247

Announcements - 1247

New Features - 1247

Changed Functionality - 1247

Documentation Changes and Errata - 1247

For a current list of known issues, see API Status and the Knowledge Base.

Index of Changed Calls - 1247

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

No changed calls in this release.

Schema Changes - 1247

None for this release.

Announcements - 1247

Change Requests

See the API Status for bug fixes related to this release.

New Features - 1247

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 - 1247.

None for this release.

Changed Functionality - 1247

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.

HitCount Field Deprecated

Hit counters are no longer displayed in View Item pages, so the HitCount field returned in GetSingleItem and GetMultipleItems are no longer applicable and are scheduled for decommission. For developers/sellers who are interested in seeing page views and listing performance, the getTrafficReport method of the Sell Analytics API can be used.

Documentation Changes and Errata - 1247

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1247 and Changed Functionality - 1247.

None for this release.

Version 1199

Index of Changed Calls - 1199

Schema Changes - 1199

Announcements - 1199

New Features - 1199

Changed Functionality - 1199

Documentation Changes and Errata - 1199

For a current list of known issues, see API Status and the Knowledge Base.

Index of Changed Calls - 1199

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 - 1199

No schema changes in this release.

Announcements - 1199

Change Requests

See the API Status page for bug fixes related to this release.

New Features - 1199

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 - 1199.

None for this release.

Changed Functionality - 1199

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.

The Max Length of Feedback Comment Fields Increased to 500 Characters.

The maximum length of the Feedback comment-related fields in GetUserProfiles has been increased to 500 characters. This change applies to the CommentText, FeedbackResponse, and Followup fields.

Documentation Changes and Errata - 1199

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1199 and Changed Functionality - 1199.

None for this release.

Version 1157

Index of Changed Calls - 1157

Schema Changes - 1157

Announcements - 1157

New Features - 1157

Changed Functionality - 1157

Documentation Changes and Errata - 1157

For a current list of known issues, see API Status and the Knowledge Base.

Index of Changed Calls - 1157

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 - 1157

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.

No schema changes in this release.

Announcements - 1157

Added Support for OAuth Tokens

Instead of passing in an App ID through the appid URL parameter or through the X-EBAY-API-APP-ID HTTP header, a developer can now use the new X-EBAY-API-IAF-TOKEN HTTP header to pass in an OAuth application access token. See the The client credentials grant flow topic for more information on generating and managing OAuth application access tokens.

Note: Starting on July 1, 2021, developers using Shopping API calls must authenticate with an OAuth application access token using the X-EBAY-API-IAF-TOKEN HTTP header, as both the appid query parameter and X-EBAY-API-APP-ID HTTP header will be deprecated on June 30, 2021. Developers should start making plans at their earliest convenience to migrate to using OAuth application access tokens with https://api.ebay.com/oauth/api_scope scope.

See the API Status for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, or additional support resources.

New Features - 1157

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 - 1157.

Changed Functionality - 1157

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 - 1157

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1157 and Changed Functionality - 1157.

Clarified the Behavior of Domestic and International Return Policies

Updated return policy-related documentation to make it more clear that if a seller does not add a separate international return policy for an item, the settings in the domestic return policy will be used instead. For more information, see the ReturnPolicy container in GetSingleItem call.

Version 1145

Index of Changed Calls - 1145

Schema Changes - 1145

Announcements - 1145

New Features - 1145

Changed Functionality - 1145

Documentation Changes and Errata - 1145

For a current list of known issues, see API Status and the Knowledge Base.

Index of Changed Calls - 1145

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 - 1145

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.

No schema changes in this release.

Announcements - 1145

Change Requests

See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.

CharityNumber Field Scheduled to be Deprecated

The CharityNumber field returned in GetSingleItem and GetMultipleItems has been scheduled for deprecation. It is the CharityID value that should be used instead if the user wishes to retrieve more details on a nonprofit organization by using the Trading API's GetCharities call, or used by a seller in an Add/Revise/Relist call when they want to identify the nonprofit organization that will receive sale proceeds for a listing.

New Features - 1145

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 - 1145.

None for this release.

Changed Functionality - 1145

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 - 1145

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1145 and Changed Functionality - 1145.

Clarified Difference Between CharityID and CharityNumber Identifiers

Updated the CharityID and CharityNumber field descriptions to make it clear that CharityID is the eBay-assigned unique identifier for an eBay for Charity organization, and CharityNumber is the PayPal Giving Fund identifier. It is the CharityID value that should be used to identify a charity organization in an Add/Revise/Relist or GetCharities call in Trading API

Back to top

Version 1139

Index of Changed Calls - 1139

Schema Changes - 1139

Announcements - 1139

New Features - 1139

Changed Functionality - 1139

Documentation Changes and Errata - 1139

For a current list of known issues, see API Status and the Knowledge Base.

Index of Changed Calls - 1139

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 - 1139

None for this release.

Announcements - 1139

Change Requests

See the API Status for bug fixes related to this release.

New Features - 1139

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 - 1139.

None for this release.

Changed Functionality - 1139

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.

PostalCode to Start Being Masked in GetSingleItem/GetMultipleItems

Postal code values returned in the Item.PostalCode field of GetSingleItem/GetMultipleItems will be masked to all users except for the seller of the item. Different countries will mask postal/zip codes in slightly different ways, but an example would be 951**.

Documentation Changes and Errata - 1139

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1139 and Changed Functionality - 1139.

Added Site-Specific Max Length Values for Address Fields

Added site-specific max length values for several address-related fields (in AddressType), including Street1, Street2, CityName, StateOrProvince, and PostalCode. For all five of these fields, the max lengths according eBay marketplace are shown:

  • UK, Ireland, Germany, and Austria: 35
  • US (including Motors) and Canada (English and French versions): 40
  • Australia: 80
  • All other sites: 50