Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

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.

Files for ebayfeed, version 2018.11.1
Filename, size File type Python version Upload date Hashes
Filename, size ebayfeed-2018.11.1-py3-none-any.whl (9.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ebayfeed-2018.11.1.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page