Welcome to the python ebaysdk

This SDK is a programmatic interface into the eBay APIs. It simplifies development and cuts development time by standardizing calls, response processing, error handling, and debugging across the Finding, Shopping, Merchandising & Trading APIs.

Quick Example:

import datetime
from ebaysdk.exception import ConnectionError
from ebaysdk.finding import Connection

try:
    api = Connection(appid='YOUR_APPID_HERE', config_file=None)
    response = api.execute('findItemsAdvanced', {'keywords': 'legos'})

    assert(response.reply.ack == 'Success')
    assert(type(response.reply.timestamp) == datetime.datetime)
    assert(type(response.reply.searchResult.item) == list)

    item = response.reply.searchResult.item[0]
    assert(type(item.listingInfo.endTime) == datetime.datetime)
    assert(type(response.dict()) == dict)

except ConnectionError as e:
    print(e)
    print(e.response.dict())

Migrating from v1 to v2

For a complete guide on migrating from ebaysdk v1 to v2 and see an overview of the additional features in v2 please read the v1 to v2 guide

Getting Started

1. SDK Classes

• Trading API Class - secure, authenticated access to private eBay data.
• Finding API Class - access eBay's next generation search capabilities.
• Shopping API Class - performance-optimized, lightweight APIs for accessing public eBay data.
• Merchandising API Class - find items and products on eBay that provide good value or are otherwise popular with eBay buyers.
• HTTP Class - generic back-end class the enbles and standardized way to make API calls.
• Parallel Class - SDK support for concurrent API calls.

2. SDK Configuration

• Using the SDK without YAML configuration

  ebaysdk.finding.Connection(appid='...', config_file=None)

• YAML Configuration

• Understanding eBay Credentials

3. Sample code can be found in the samples directory.
4. Understanding the Request Dictionary.

Support

For developer support regarding the SDK code base please use this project's Github issue tracking.

For developer support regarding the eBay APIs please use the eBay Developer Forums.

Install

Installation instructions for *nix and windows can be found in the INSTALL file.

License

COMMON DEVELOPMENT AND DISTRIBUTION LICENSE Version 1.0 (CDDL-1.0)