You are here: Buy APIs > Browse API overview

Browse API overview

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 items and item groups 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. This resource also provides bridge between the RESTful Buy APIs and the legacy APIs, such as Trading and Finding. (Get Item calls)

For more details, see Buying Integration Guide.

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 by Item Group call accepts item Ids from the eBay traditional APIs, such as the Trading API or Finding API. See the Legacy API compatibility section of the Buying Integration Guide.

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.