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.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.9.0 2021-10-18 Added Browse API support for two new marketplaces: Austria (AT) and Switzerland (CH)
v1.8.0 2021-09-08

Added the priorityListing response field to the search method

Added the sort option EndingSoonest for listings in search results

v1.7.0 2021-08-12 Added support for AUTHENTICITY_GUARANTEE to the qualifiedPrograms filter URI parameter in the search and searchByImage resource methods

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.

v1.9.0

The following section describes the changes made in this release.

Added Browse API support for AT and CH marketplaces

The Browse API methods item and item_summary are enabled for the Austria (AT) and Switzerland (CH) marketplaces.

v1.8.0

The following section describes the changes made in this release.

Added priorityListing response field

The search method now returns the priorityListing field.

When the value is true, this field indicates that the seller has made the item a priority listing, such as by making it a Promoted Listing. Promoted Listings are available to Above Standard and Top Rated sellers with recent sales activity. For more information, see Promoted Listings.

Added EndingSoonest sort option

Search results can now be sorted by EndingSoonest. This shows items in order of the date and time when the listing ends, starting with the listing with the nearest end date/time.

v1.7.0

The following section describes the changes made in this release.

Added AUTHENTICITY_GUARANTEE to qualifiedPrograms filter

Support for AUTHENTICITY_GUARANTEE was added to the qualifiedPrograms filter URI parameter in the search and searchByImage resource methods. The new filter returns only the items that are qualified for the Authenticity Guarantee program. This program enables third-party authenticators to perform authentication verification inspections on items.

Note: Refer to the Buy API Field Filters section of the Buying Integration Guide for details and examples for all the available filters.