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)