Just getting started with the Browse API? See the following documents for details on using this API:

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 recent Browse API releases. For older releases, see the Browse API Release Notes Archive.

Release Version Release Date Description of Release
v1.19.6 2024-03-19

Expanded values for the itemLocationRegion filter for the search method. Added support for the Belgium marketplace.

v1.19.5 2024-02-13 Added support for the itemLocationRegion filter for the search method.
v1.19.4 2024-01-30 Added support for required Economic Operator information.
v1.19.3 2024-01-29 Expanded marketplace support for auto correction of browse terms.
v1.19.2 2023-10-24 Added support for the userId response field to the following methods: getItem, getItemByLegacyId, and getItemsByItemGroup.
v1.19.1 2023-08-10 Added new Error Code 12516 for search method.
v1.19.0 2023-06-26 Added support for the conditionDescriptors field to the following methods: getItem, getItemByLegacyId, getItemsByItemGroup
v1.18.4 2023-05-31 Waste Electrical and Electronic Equipment (WEEE) registration number is now returned.
v1.18.3 2023-03-17 Removed the shopping_cart resource and methods as the Browse API no longer supports the Shopping Cart.
v1.18.2 2023-02-08 Added support for the fields hazardousMaterialsLabels and repairScore to the following methods: getItem, getItemByLegacyId, and getItemsByItemGroup.
v1.18.1 2022-11-09 Added check and error for limit and offset relation condition for the search and searchByImage methods

v1.19.6

The following changes have been made in this release:

Expanded values for itemLocationRegion filter

The itemLocationRegion filter has been expanded to include the following values: 

  • ASIA

  • BORDER_COUNTRIES

  • CONTINENTAL_EUROPE

  • EUROPEAN_UNION

  • NORTH_AMERICA

  • UK_AND_IRELAND

New error code

A new error code 12517 has been added in the search method with the following description: "The 'itemLocationRegion' filter value is not supported for the marketplace {marketplaceId}. Valid values are: {validRegionValues}."

Expanded supported marketplaces

Belgium (EBAY_BE) has been added as a supported marketplace for the Browse API.

Added Accept-Language header

The Accept-Language header has been added to methods of the Browse API. This header allows users to toggle between supported languages on the Belgian and Canadian marketplaces. For more information on this header, see HTTP request headers.

v1.19.5

The following changes have been made in this release:

Added itemLocationRegion filter

The search method now supports the itemLocationRegion filter. This filter allows only items located in a specific region to be returned in the response. The only currently supported value is WORLDWIDE.

New error code

A new error code 12517 has been added in the search method with the following description: "Only one item location filter can be applied at a time. Refer to the API call documentation."

v1.19.4

The following changes have been made in this release:

Schema changes

To support new legal requirements by the European Union and the UK to provide Economic Operator information, the following schema changes have been made:

  • The following new type has been added to the getItem, getItemByLegacyId, getItems, and getItemsByItemGroup methods:
    • EconomicOperator: provides required Economic Operator information about the manufacturer and/or supplier of the item.
  • The following new field has been added to the SellerLegalInfo type:
    • economicOperator: Provides required information about the manufacturer and/or supplier of the item.

v1.19.3

The following changes have been made in this release:

Expanded marketplace support for auto correction of browse terms

The list of marketplaces that support the auto correction of browse terms has been expanded and now includes:

  • Austria
  • Australia
  • Canada
  • Switzerland
  • Germany
  • Spain
  • France
  • United Kingdom
  • Ireland
  • Italy

Schema changes

There are no schema changes associated with this release.

v1.19.2

The following changes have been made in this release:

Added the userId field

The userId field can now be returned for the getItems, getItembyLegacyId, and getItemsByGroupId methods. This field provides the unique identifier of a seller across all eBay sites. This value does not change, even when a user changes their username. This field is only returned when setting fieldgroups to ADDITIONAL_SELLER_DETAILS.

Added the ADDITIONAL_SELLER_INFORMATION fieldgroup

A new fieldgroups value ADDITIONAL_SELLER_DETAILS has been added to support this feature. Setting fieldgroups to ADDITIONAL_SELLER_DETAILS adds the userId field to the response.

v1.19.1

The following change has been made in this release.

Added new Error Code

A new error code 12516 has been added in the search method with description "The ‘q’ value is invalid. It must be longer than one character when using the ‘searchInDescription’ filter."

v1.19.0

The following changes have been made in this release.

Added the conditionDescriptors field

To support the return of condition descriptor information for applicable items, the following new array has been added to the getItem, getItemByLegacyId, and getItemsByItemGroup method:

  • conditionDescriptors: provides additional information about the condition of an item in a structured format.

Note: Condition descriptors are currently only available for the following trading card categories:

  • Non-Sport Trading Card Singles
  • CCG Individual Cards
  • Sports Trading Card Singles


Note: Condition descriptors are currently only available for the United Kingdom (GB) marketplace.

v1.18.4

The following changes have been made in this release.

Schema updates

To support the return of Waste Electrical and Electronic Equipment (WEEE) information, the following new field has been added to the SellerLegalInfo type:

  • weeeNumber: the manufacturer number assigned to first distributors of electrical and electronic equipment.

v1.18.3

The following section describes the changes made in this release.

Removed Shopping Cart

The Browse API no longer supports the Shopping Cart, so the shopping_cart resource and methods, addItem, getShoppingCart, removeItem, and updateQuantity, have been removed from the documentation set.

v1.18.2

The following section describes the changes made in this release.

Added the field hazardousMaterialsLabels

The following methods now return the field hazardousMaterialsLabels: getItem, getItemByLegacyId, and getItemsByItemGroup.

The hazardousMaterialsLabels field provides information about hazardous material labels that apply to an item. It includes arrays of two additional fields, hazardPictogram and hazardStatement.

Added the field repairScore

The following methods now return the field repairScore: getItem, getItemByLegacyId, and getItemsByItemGroup.

The repairScore field represents the Repair Index, a value that indicates how easy it is to repair the item. Score values range from 0.1 (hardest to repair) to 10.0 (easiest), always including a single decimal place. Note: Support for this field is currently limited to the France marketplace.

v1.18.1

The following section describes the changes made in this release.

Added error for limit and offset relation condition

Error code 12515 was added to the search and searchByImage methods.

Error ID Message
12515 The 'offset' value must be either zero or a multiple of the 'limit' value.

v1.18.0

The following sections describe the changes made in this release.

categoryName field

Each category object returned by the methods search and searchByImage now includes the field categoryName. Previously, only categoryId was returned.

leafCategoryIds array

Responses for the methods search and searchByImage now include an array of leaf category IDs for each item. An item can have up to two leaf categories. When this is the case, the leaf category IDs are returned in the order primary, secondary.

International Shipping

The field shippingOptions.fulfilledThrough now includes INTERNATIONAL_SHIPPING as a supported enumerated value. This value indicates that the item is being shipped through the eBay International Shipping program. This change affects responses for the methods getItem, getItemByLegacyId, and getItemsByItemGroup.