Skip to main content

Download item feeds from eBay RESTful APIs.

Project description


Build Status Build status codecov PyPI version Downloads Code style: black

Download item feeds from eBay RESTful API.

NOTE: As of Nov.2018 Feed API (v1_beta.10.0) are available only for the following marketplaces:

  • EBAY-DE - eBay Germany (
  • EBAY-GB - eBay Great Britain (
  • EBAY-US - eBay USA (

Package will be updated as soon as other marketplaces are added. More info here.

Feed API release notes


To install, use pip or easy_install:

$ pip install --upgrade ebayfeed


$ easy_install --upgrade ebayfeed

How to create a keyset

Sign in to your eBay Developers Program account to create an App ID and a keyset.

You can test your application in eBay's sandbox environment without limitations.

To download item feeds from eBay's production environment, your keyset needs to be granted access to OAuth scope.

You can obtain such authorization by completing all the steps described here: apply for production access.


Get all items for {'Travel': 3252} category and convert them to pandas dataframe:

import ebayfeed
from pandas import read_table
from pandas.compat import StringIO

# download tsv feed
credentials = ebayfeed.Credentials(client_id, client_secret)
feed = ebayfeed.get_feed(credentials, 3252, ebayfeed.SCOPE_ALL_ACTIVE, ebayfeed.EBAY_US)

# convert to dataframe
df = read_table(StringIO(tsv_feed.splitlines()))

Use eBay's sandbox environment instead of production:

sandbox_api = ebayfeed.Api(env=ebayfeed.ENVIRONMENT_SANDBOX)
credentials = ebayfeed.Credentials(client_id, client_secret, api=sandbox_api)

Get items listed on 2018-10-03 for {'Toys & Hobbies': 220} category:

feed = ebayfeed.get_feed(credentials, 220, ebayfeed.SCOPE_NEWLY_LISTED, ebayfeed.EBAY_US, date='20181003')

Get top-level category names and IDs for a given marketplace from Taxonomy API:

categories = ebayfeed.get_macro_categories(credentials, ebayfeed.EBAY_DE)

Get access token to taxonomy and buy.item.feed OAuth scopes (cached until expiration):

credentials = ebayfeed.Credentials(client_id, client_secret)
access_token = credentials.access_token


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ebayfeed-2018.11.1-py3-none-any.whl (9.6 kB) Copy SHA256 hash SHA256 Wheel py3
ebayfeed-2018.11.1.tar.gz (6.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page