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.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.18.0 | 2022-09-02 |
Added the field categoryName to category objects in responses for the methods search and searchByImage Added leafCategoryIds to items in responses for the methods search and searchByImage Added INTERNATIONAL_SHIPPING to the list of enumerated values for the field fulfilledThrough; this affects the methods getItem, getItemByLegacyId, and getItemsByItemGroup |
v1.17.0 | 2022-07-21 | Added the response field categoryIdPath to the methods getItem, getItemByLegacyId, getItems, and getItemsByItemGroup |
v1.16.0 | 2022-05-05 | CLASSIFIED_AD has been added as a new option for the buyingOptions filter and the BUYING_OPTIONS_REFINEMENT fieldgroup |
v1.15.0 | 2022-04-13 | Added the itemCreationDate response field to the getItem, getItemByLegacyId, getItems, and getItemsByItemGroup methods |
v1.14.0 | 2022-03-28 | Added the shippingOptions array to the response fields returned by the getItems method and when the parameter "fieldgroups=COMPACT" is passed in with the getItem method. |
v1.13.0 | 2022-02-16 | Added the response field addOnServices to the getItem, getItemByLegacyId, and getItemsByItemGroup methods in the Browse Search API |
v1.12.0 | 2022-01-24 |
Added the response field itemCreationDate to the search method in the Browse Item API Added the response field listingMarketplaceId to the getItem, getItemByLegacyId, getItemsByItemGroup, and search methods in the Browse Search API |
v1.11.0 | 2021-12-15 |
Added the response fields sellerCustomPolicies and ecoParticipationFee to the getItem, getItemByLegacyId, and getItemsByItemGroup methods in the Browse Item API Added five auction-related response fields to the getItem and getItems methods in the Browse Item API. |
v1.10.0 | 2021-11-01 |
Added the response fields priorityListing and watchCount to the getItem, getItems, getItemByLegacyId, and getItemsByItemGroup methods in the Browse Item API Added the response field watchCount to the search and searchByImage methods in the Browse Search API Added the filter priorityListing to the search method in the Browse Search API |
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.
v1.17.0
The following section describes the changes made in this release.
Added categoryIdPath response field to Browse API
The getItem, getItemByLegacyId, getItems, and getItemsByItemGroup methods now return the response field categoryIdPath. This field contains the IDs of every category in the item path, separated by pipe characters, starting with the top level parent category.
For example, if an item belongs to the top level category Home and Garden (category ID 11700), followed by Home Improvement (159907), Heating, Cooling and Air (69197), and Thermostats (115947), the field would return the value: 11700|159907|69197|115947
.
v1.16.0
The following section describes the changes made in this release.
CLASSIFIED_AD is added as a buyingOptions value
The string value CLASSIFIED_AD can be applied as a buyingOptions filter for the following methods:
- search
- searchByImage
The string value CLASSIFIED_AD is now returned in the buyingOptions array response for the following methods:
- getItem
- getItemByLegacyId
- getItems
- getItemsByItemGroup
- search
- searchByImage
Note: Refer to the Buy API Field Filters section of the Buying Integration Guide for details and examples for all the available filters.
In addition, the string value CLASSIFIED_AD is now included in the BUYING_OPTIONS_REFINEMENTS fieldgroup and may be returned within the buyingOptionDistributions array for those searches where BUYING_OPTIONS_REFINEMENTS has been set as a fieldgroup.
v1.15.0
The following section describes the changes made in this release.
Added itemCreationDate response field
The following methods now return the itemCreationDate field:
- getItem
- getItemByLegacyId
- getItems
- getItemsByItemGroup
This response field returns a timestamp that indicates the date and time an item listing was created.
Note: The timestamp value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which can be converted into the local time of the buyer.
v1.14.0
The following section describes the changes made in this release.
Added shippingOptions to the response fields for getItems and to the COMPACT option for getItem
The getItems method now returns the shippingOptions array of fields.
shippingOptions fields are also returned when the parameter "fieldgroups=COMPACT" is passed in with the getItem method.
v1.13.0
The following section describes the changes made in this release.
Added addOnServices response field to Browse Item API
The getItem, getItemByLegacyId, and getItemsByItemGroup methods now return the response field addOnServices, an array of add-on services that apply to an item, such as the eBay Authenticity Guarantee service.
An add-on service may be optional or required and may apply a fee to the item purchase.
v1.12.0
The following section describes the changes made in this release.
Added itemCreationDate and listingMarketplaceId response fields to Browse Item API
The getItem, getItemByLegacyId, getItemsByItemGroup, and search methods now return the response field listingMarketplaceId. This value indicates the eBay marketplace where the item is listed.
The search method now returns the response field itemCreationDate. This value indicates the date and time when the item listing was created.
v1.11.0
The following sections describe the changes made in this release.
Added sellerCustomPolicies and ecoParticipationFee response fields to Browse Item API
The getItem, getItemByLegacyId, and getItemsByItemGroup methods now return the response fields sellerCustomPolicies and ecoParticipationFee.
These fields implement support for extended producer responsibility (EPR) laws and regulations that are in effect in some countries.
The sellerCustomPolicies field lists custom policies that a seller applies to a listing. Currently, these policies can be one of the following types:
PRODUCT_COMPLIANCE
: Discloses product information as required for regulatory compliance.TAKE_BACK
: Describes the seller's legal obligation to take back a previously purchased item when the buyer purchases a new one.
The ecoParticipationFee field defines the amount remitted to an eco organization, applied to the cost of the eventual disposal of the item.
Added five auction-related response fields to Browse Item API
The getItem (COMPACT) and getItems methods now return the following five auction-related response fields:
- bidCount: an integer value that indicates the current number of bids for an auction item.
- currentBidPrice: a string indicating the current highest bid for an auction item.
- minimumPriceToBid: a string indicating the minimum price of the next bid; to place a bid it must be equal to or greater than this amount.
- reservePriceMet: a boolean value indicating if the seller-specified reserve price for an auction item has been met.
- uniqueBidderCount: an integer value indicating the number of different eBay users who have placed one or more bids on an auction item.
v1.10.0
The following sections describe the changes made in this release.
Added priorityListing and watchCount response fields to Browse Item API
The getItem, getItems, getItemByLegacyId, and getItemsByItemGroup methods now return the response fields priorityListing and watchCount.
The priorityListing field is a boolean value that indicates whether the listing is a part of a Promoted Listing campaign.
The watchCount field is an integer value that indicates the number of users that have added the item to their watch list.
Added watchCount response field to Browse Search API
The search and searchByImagemethods now return the response field watchCount.
The watchCount field is an integer value that indicates the number of users that have added the item to their watch list.
Added priorityListing filter to Browse Search API
The search method now supports the priorityListing
filter parameter. When set to true
, this filter returns only items that are a part of a Promoted Listing campaign.
Note: Refer to the Buy API Field Filters section of the Buying Integration Guide for details and examples for all the available filters.