You are here: Buy APIs > Browse API

Browse API

The Browse API is part of the eBay Buy APIs. It retrieves items and item details for active eBay listings to help buyers find the items they want to buy easily. Use the Browse API with the Order API to create a buying application that lets users, eBay members or guests, buy from eBay sellers without visiting the eBay site. The Buy APIs provide a unique opportunity to bring off-eBay purchases to your site.

Topics

Overview

Using the Browse API, you can create a rich selection of items for your buyers to browse by getting feed files or with keyword searches. Item feeds can be returned as JSON in the response or as a tab-separated value (TSV) text files that eBay creates daily for a variety of categories. Each feed file contains thousands of items, which you can use to pre-populate your app. Both item feeds and search results contain only items that have a Buy It Now price.

If search returns an item group (i.e., item with multiple variations), you can retrieve each purchasable item. And, in turn, you can get details for a given purchasable item.

This API uses the following resources:

  • ITEM_FEED – a text file or JSON, containing basic item details for thousands of items listed in a given eBay category and site. (Get Item Feed call)
  • ITEM_SUMMARY – basic information for an item, such as title, pricing, image, and seller. (Search for Items call)
  • ITEM - detailed information for a purchasable item to enable users to make buying decisions. In addition to the basic item information, such as pricing and title, the item details include shipping options, product review data, item location, condition, return policy terms, and more. (Get Item call)
  • ITEM_GROUP - basic information for an item with multiple variations, including item IDs, which can be used to look up details for individual, purchasable items. (Get Item Group call)

Use cases

When used with the Order API, the Browse API lets you create shopping/buying opportunities virtually anywhere. For example, your buyers can have a seamless buying experience woven into a social application.

Dependencies, Limitations, and Restrictions

Please note the following constraints for the Browse API.

API Dependencies

The Browse API is designed to be used together with the Order API to create cohesive buying applications. The identifiers used in the Browse API are not compatible with other APIs.

Note: The Get Item Group call accepts item Ids from s from eBay traditional APIs, such as the Trading API or Finding API.

Regional/site constraints

The Browse API is currently supported for the eBay US site.

eBay policies and rules

Although the eBay Buy APIs are available for anyone to use in eBay's sandbox environment, use of the APIs in production is restricted. Users must meet standard eligibility requirements, get approvals from eBay support organizations, and sign contracts with eBay and PayPal to access the Buy APIs in production.

See Production eligibility requirements in the Buying Integration Guide for more information.