browse APIv1_beta.15.0

Browse API Release Notes

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_beta.15.0

2018-07-30

Experimental Release Added search_by_image resource (Note: This is an Experimental Release).

v1_beta.14.0

2018-07-24

Experimental Release Added shopping_cart resource (Note: This is an Experimental Release.)

v1_beta.13.0

2018-07-19

The search call now returns the itemLocation.city field when fieldgroups is set to EXTENDED.

v1_beta.12.0

2018-07-02

  • Added shortDescription to the search call response
  • Added EXTENDED to fieldgroups, which causes the shortDescription to be returned

v1_beta.11.0

2018-03-29

Added the enabledForGuestCheckout field to the getItem, getItemsByItemGroup, and getLegacyItem calls

v1_beta.10.0

2018-02-12


2017-11-10

The getItem and getLegacyItem calls:
Removed the alternate product IDs from the additionalProductIdentities.productIdentity container.

The getItem and getLegacyItem calls:

  • Added the value PRODUCT to the fieldgroups URI parameter
  • Added product type

All Browse API calls:

  • Added unitPrice and unitPricingMeasure fields

v1_beta.9.0

2017-10-23

Added adultOnly field to the Browse API call responses

Added categoryId field to the getItem and getItemByLegacyId call responses

v1_beta.8.0

2017-09-21

  • Added fieldgroups URI parameter to the getItem call
  • Added new sellerItemRevision field to the getItem call
  • Added new error message to the search call

 

v1_beta.15.0

The search_by_image resource has been added to the Browse API, which lets you search for items by an image. (Note: This is an Experimental Release.)

You pass in a Base64 image ID in the request payload and can refine the search results by category, eBay product ID (ePID), or GTIN, or a combination of these using URI parameters.

v1_beta.14.0

The shopping_cart resource has been added to the Browse API, which lets you add, remove, and change the quantity of items in an eBay member's cart. (Note: This is an Experimental Release.)

This resource has the following calls:

  • addItem - This call creates a cart for the eBay member if it doesn't exist and adds items to that cart. To use this call, you must submit a RESTful item ID and the quantity of the item.
  • getShoppingCart - This call retrieves the contents of the eBay member's cart on eBay. There is no URI parameters or request payload. This call returns the summary details of all the items in the cart; items added to the cart while on ebay.com as well as items added to the cart using the Browse API.
  • removeItem - This call removes a specific item from the eBay member's cart on eBay. You specify the ID of the item in the cart (cartItemId) you want to remove.
  • updateQuantity - This call updates the quantity value of a specific item in the cart. You specify the ID of the item in the cart (cartItemId) and the new value for the quantity.

v1_beta.13.0

The search call now populates the itemLocation.city field when fieldgroups is set to EXTENDED. This lets you filter the result set by a specific city.

v1_beta.12.0

Added the shortDescription field to the search call response. This field returns a text string that is derived from the item condition and the item aspects (such as size, color, capacity, model, brand, etc.). Sometimes the title doesn't give enough information but the description is too big. Surfacing the shortDescription can often provide buyers with the additional information that could help them make a buying decision.

For example:

"title": "Petrel U42W FPV Drone RC Quadcopter w/HD Camera Live Video One Key Off / Landing",
"shortDescription": "1 U42W Quadcopter. Syma X5SW-V3 Wifi FPV RC Drone Quadcopter 2.4Ghz 6-Axis Gyro with Headless Mode. Syma X20 Pocket Drone 2.4Ghz Mini RC Quadcopter Headless Mode Altitude Hold. One Key Take Off / Landing function: allow beginner to easy to fly the drone without any skill.",


Restriction: This field is returned only when fieldgroups = EXTENDED.

v1_beta.11.0

The enabledForGuestCheckout field was added to the getItem, getItemsByItemGroup, and getLegacyItem calls.

New Field

Field Description

enabledForGuestCheckout Indicates if the item can be purchased using Guest Checkout in the Order API. You can use this flag to exclude items from your inventory that are not eligible for Guest Checkout, such as gift cards.

v1_beta.10.0

This section covers the changes that were made in this version of the Browse API. The release on 2017-11-10 added new fields and a new fieldgroups URI parameter. The release on 2018-02-13 changed the contents of the additionalProductIdentities.productIdentity container.

2018-02-13

The additionalProductIdentities.productIdentity container will now return only one UPC and EAN product ID.

Previous Response

New Response

"additionalProductIdentities": [
  {
    "productIdentity": [
      {
        "identifierType": "UPC",
        "identifierValue": "0190198462930"
      },
      {
        "identifierType": "UPC_12",
        "identifierValue": "190198462930"
      },
      ...
      }
    ]
  },
  {
    "productIdentity": [
      {
        "identifierType": "EAN",
        "identifierValue": "0190198462930"
      },
      {
        "identifierType": "EAN_13",
        "identifierValue": "0190198462930"
      ...
      }
    ]
  },
"additionalProductIdentities": [
  {
    "productIdentity": [
      {
        "identifierType": "UPC",
        "identifierValue": "0190198462930"
      }
    ]
  },
  {
    "productIdentity": [
      {
        "identifierType": "EAN",
        "identifierValue": "0190198462930"
      }
    ]
  },

 

2017-11-10

You can now use the getItem and getLegacyItem calls to retrieve product details for an item. The product information is returned in the new product type fields. This type is included in the response when the fieldgroups URI parameter is set to PRODUCT. You can also retrieve the price per unit, which helps buyers accurately compare prices.

Added the PRODUCT fieldgroups value

When you set the URI parameter fieldgroups to PRODUCT, it adds fields to the response containing information about the product associated with the item.

Added Product type

The product type has been added to the getItem and getItemByLegacyId calls. This type is returned only if the URI parameter fieldgroups is set to PRODUCT. The following table lists the fields or types returned in the product type. See the getItem call for details about these new types and fields. For an example of the response, see Get item details and the item product information sample.

product Type Field/Types

Description

product.additionalImages An array of containers with the URLs for the product images that are in addition to the primary image.
product.additionalProductIdentities A product can have more than one identifier value for a product type, such as UPC, EAN, ect. For example, the same product UPC can have an identifier that is 12, 13, or 14 digits.

This container returns an array of all the product identifiers (type/value pairs) associated with the product. These are in addition to the identifiers returned in the mpn and gitn fields.
product.aspectGroups An array of containers for the product aspects. Each group contains the aspect group name and the aspect name/value pairs.
product.brand The brand associated with the product. To identify the product, this is always used along with MPN (manufacturer part number).
product.description The rich description of an eBay product, which might contain HTML.
product.gtins An array of all the possible GTINs values associated with the product. A GTIN is a unique Global Trade Item number of the item. This can be a UPC (Universal Product Code), EAN (European Article Number), or an ISBN (International Standard Book Number) value.
product.image The primary image of the product. This is often a stock photo.
product.mpns An array of all possible MPN values associated with the product. A MPNs is manufacturer part number of the product. To identify the product, this is always used along with brand.
product.title The title of the product.

 

Added unitPrice and unitPricingMeasure fields

The unitPrice and unitPricingMeasure fields were added to all the Browse APIs calls.

New Field

Field Description

unitPrice This is the price per unit for the item. The European Union requires listings for certain types of products to include the price per unit so buyers can accurately compare prices.
unitPricingMeasure The designation, such as size, weight, volume, count, etc., that was used to specify the quantity of the item.

 

v1_beta.9.0

The following fields were added to the Browse API call responses.

New Field

Call

Field Description

adultOnly All Browse API calls This indicates if the item is for adults only. For more information about adult-only items on eBay, see Adult items policy for
sellers and Searching for adult only items for buyers.
categroyId getItem and getItemByLegacyId calls The ID of the category for the item.

 

v1_beta.8.0

The following changes were made to the Browse API.

Added fieldgroups URI parameter to the getItem call

The fieldgroups URI parameter was added to the getItem call to enable you to control what is returned in the response. The Buy APIs are designed to let you create an eBay shopping experience in your app or website. This means you will need to know when item details, such as the price, availability, etc., has changed in any eBay item you are offering. You can now do this easily by setting fieldgroups to COMPACT, which reduces the response to only the fields that you need in order to check if any item detail has changed. For more information, see fieldgroups.

Add sellerItemRevision field to the getItem call

The sellerItemRevision field is n identifier generated/incremented when a seller revises the item. There are two types of item revisions; seller changes, such as changing the title, and eBay system changes, such as changing the quantity when an item is purchased. This ID is changed only when the seller makes a change to the item. This means you cannot use this value to determine if the quantity has changed.

New error message

The following error message was added to the search call.

Error ID

Error Description

12023 This keyword search results in a response that is too large to return. Either change the keyword or add additional query parameters and/or filters.