Skip to main content

feed APIv1.0.0

Feed API Overview

Looking for the Feed API beta documents? You can access them here.

The Feed API gives you the ability to:

  • Download a feed file containing all of the items in an eBay L1 category for a specific eBay marketplace
  • Download a curated item feed file containing all items
  • Curate the items off-line by item aspects, price, product, payment method, ship to location, etc.
  • Keep your item information up to date

Note: This is a (Limited Release) API available only to select developers approved by business units

Topics

Technical overview

Using the Feed API, you can download a rich selection information about items and products for your buyers. The Item feeds enable you to retrieve details of eBay marketplace items across various top-level (L1) categories. The list of L1 categories is available through the Taxonomy API.

An L1 category in the Taxonomy API response will have a categoryTreeNodeLevel value of 1.

This API uses the following methods:

  • getAccess - Returns the the details of the application's feed file access configuration. Lists the marketplaces and categories for which the application can download feeds.
  • getFeedTypes - Returns a list of all the feeds available to download, listed by feed type. The response included information on the feed's scope (daily, hourly, or weekly), supported feeds in that type, marketplace and status (active, paused, or deprecated).
  • getFeedType - Returns a list of the feeds of a particular feed type that are available for download. The response included information on the feed's scope (daily, hourly, or weekly), supported feeds in that type, marketplace and status (active, paused, or deprecated).
  • getFile - Returns selected metadata about a specified download file. It includes details on the date of its feed, its file type, its scope, its format, and the marketplace(s) it describes.
  • get Files - Returns a list of the feed files available to download. The file search can be filtered in the URI by feed type, feed scope, category id, and how far back in time from the present the feed was made available.
  • downloadFile - Returns the GZIP feed file.

Business use cases

When used with the other Buy APIs, the Feed API lets you create shopping/buying opportunities virtually anywhere. For example, your buyers can have a seamless buying experience woven into a social application. This section outlines the high-level use cases for the Feed API.

Get a daily feed files of curated items

You can download a daily feed file of curated items for a specific date and L1 category.

API restrictions

Please note the following constraints for the Feed API.

Note: In addition to the Feed API restrictions below, there are also requirements for using the Buy APIs. For more information, see Buy APIs Requirements.

Regional/site constraints

For a list of the supported eBay marketplaces for a specific feed type, use the getFeedTypes method.

Note: The CURATED_ITEM_FEED is currently limited to EBAY_FR and EBAY_AU.

To access details of available feed files, set the X-EBAY-C-MARKETPLACE-ID request header. For example:

X-EBAY-C-MARKETPLACE-ID : EBAY_AU

Sandbox limitations and support

The Feed API is currently unavailable in eBay's sandbox environment, but some limitations apply.

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 to access the Buy APIs in production.

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

eBay Partner Network tracking links

If you are an EPN (eBay Partner Network) publisher you will want to advertise all eBay listings on your website with the proper tracking links. Most EPN tools and the REST APIs are capable of dynamically exposing individual tracking links for your EPN account. However, the Feed API does not provide tracking links. You can retrieve this link using the Browse getItem method. Or you can create this link. For information on how to create this link, see Create EPN Tracking Link.

Rate limits

The Feed API limits the number of calls that can be made per day on behalf of your application. For the current application rate limits, see the eBay API Call Limits page.