ebayfeed 2018.10.8

Download item feeds from eBay RESTful APIs.

ebayfeed

Download item feeds from eBay RESTful API.

NOTE: As of Oct.2018 Feed API are available only for the following marketplaces:

• EBAY-DE - eBay Germany (ebay.de)
• EBAY-GB - eBay Great Britain (ebay.co.uk)
• EBAY-US - eBay USA (ebay.com)

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

Installation

To install, use pip or easy_install:

$ pip install --upgrade ebayfeed

or

$ 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 https://api.ebay.com/oauth/api_scope/buy.product.feed OAuth scope.

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

Examples

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):

access_token = credentials.access_token

References

• Feed API documentation: https://developer.ebay.com/api-docs/buy/feed/static/overview.html
• Best practices: https://developer.ebay.com/events/connect17/sj/2-6_breakout_api-best-practices_tanya-vlahovic.pdf
• Categories map: https://www.isoldwhat.com/