Browse API Release Notes

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

• Using eBay RESTful APIs
• Buying Integration Guide
• Browse API Overview
• Browse API Reference

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.

v1_beta.21.0

This release enables you to use the search method to search for items that are compatible with a specific product. You must submit a keyword, a fitment supported category, and the attributes used to define a specific product.

New URI parameter

The compatibility_filter parameter was added. You use this field to specify the attributes that define a specific product. The service returns items matching the keyword or keyword and product attributes. For example, if the keyword is brakes and compatibility_filter=Year:2018;Make:Honda, the items returned are items with brakes, 2018, or Honda in the title.

The service then uses the product attributes to determine if the item is compatible. The service returns the attributes that are compatible and the CompatibilityMatchEnum value that indicates how well the item matches the attributes. For details, see Check compatibility in the Buy Integration Guide.

New compatibility response fields

The following compatibility response fields were added.

New error messages

Testing in Sandbox

Testing in Sandbox is only supported using mock data. See Testing search in the Sandbox for details.

v1_beta.20.0

The inferredEpid field was added to the getItem, getItemByLegacyId, getItemsByItemGroup methods. This field returns the ePID (eBay Product ID of a product from the eBay product catalog) for the item, which has been programmatically determined by eBay using the item's title, aspects, and other data. If the seller provided an ePID for the item, the seller's value is returned in the epid field.

v1_beta.19.0

The following changes have been made to the Browse API.

Added a new method

Added the checkCompatibility method to the item resource. This method checks if a product is compatible with the specified item. This method can check the compatibility of cars, trucks, and motorcycles with a specific part listed on eBay. To check for vehichle/part compatibility. you would pass in the item ID of a part as a URI parameter and specify all the attributes used to define a specific car in the compatibilityProperties container. You must also pass in EBAY_US in the X-EBAY-C-MARKETPLACE-ID request header.

If the call is successful, the response will be COMPATIBLE, NOT_COMPATIBLE, or UNDETERMINED.

URI

POST /item/{item_id}/check_compatibility

Request payload

{
  "compatibilityProperties": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

Response

{
    "compatibilityStatus": "COMPATIBLE"
}

For an example, see the Samples section of the call reference.

Added new error messages

The following new error messages have been added.

Added the ebayCollectAndRemitTax field

The ebayCollectAndRemitTax field is only returned if true, and indicates that eBay will collect tax (sales tax, Goods and Services tax, or VAT) for at least one line item in the order, and remit the tax to the taxing authority of the buyer's residence.

v1_beta.18.0

The following changes have been made to the Browse API.

Added searching for charity items capability

Added the ability to search for and filter for items associated with the specified charity. eBay charities are added to eBay through the PayPal Giving Fund. After the charity is on eBay they can be identified by their charity's registration ID, also known as the Employer Identification Number (EIN). For additional information, see eBay for Charity.

Added URI parameters

The charity_ids URI parameter has been added to the search method. This parameter is a comma separated list of charity IDs. This field limits the results to only items associated with the specified charity.

For example, charity_ids=13-1788491,300108469

Added a charity filter

The charityOnly filter has been added to enable you to limit the items returned to only items associated with a charity. For example:

/buy/browse/v1/item_summary?q=pencil&filter=charityOnly:true

v1_beta.17.0

The following changes have been made to the Browse API.

Added a new enum value

The following enumeration value was added to the priceDisplayCondition type. These enumeration values indicate when the minimum advertised price (MAP) for an item can appear in the buying flow.

ONLY_SHOW_DURING_CHECKOUT - Indicates the minimum advertised price of the item can be shown only during checkout. For example, on the "buy" page.

Changed Seller type in item resource

The item_summary and item resource both contained a Seller type. But these types were not identical, which resulted in a Seller and Seller_0 type. To fix this, the Seller type in the item resource was changed to reference the new sellerDetails type.

v1_beta.16.0

The following fields were added to the getItem and getItemByLegacyId methods. These fields return general (not specific to any bidder) bidding information for action items.

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 methods:

• addItem - This method creates a cart for the eBay member if it doesn't exist and adds items to that cart. To use this method, you must submit a RESTful item ID and the quantity of the item.
• getShoppingCart - This method retrieves the contents of the eBay member's cart on eBay. There is no URI parameters or request payload. This method 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 method 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 method 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 method 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 method 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 methods.

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.

"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 methods 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 methods. 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 method for details about these new types and fields. For an example of the response, see Get item details and the item product information sample.

Added unitPrice and unitPricingMeasure fields

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

v1_beta.9.0

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

v1_beta.8.0

The following changes were made to the Browse API.

Added fieldgroups URI parameter to the getItem method

The fieldgroups URI parameter was added to the getItem method 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 method

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