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.

Source Distribution

ebayfeed-2018.11.1.tar.gz (6.3 kB view hashes)

Uploaded Source

Built Distribution

ebayfeed-2018.11.1-py3-none-any.whl (9.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page