Skip to content
Tim Keefer edited this page Jan 31, 2014 · 17 revisions

The Finding API enables developers to access eBay's next generation search capabilities. The Finding API enables developers to search for items using eBay's next generation Finding Platform. Buying applications can build search and browse experiences using the powerful search and search refinement capabilities offered by the Finding APIs.

Usage

from ebaysdk import finding
try:
    api = finding(appid="YOUR_APPID")
    api.execute('findItemsAdvanced', {'keywords': 'Python'})
    print api.response_dict()
except ConnectionError as e:
    raise e

Usage With YAML

Place a YAML file in your home or /etc/ directory and reference that filename when constructing the object. The default YAML filename is "ebay.yaml". If you use this name it will automatically get picked up.

from ebaysdk import finding
try:
    api = finding(config_file='myfile.yaml')
    api.execute('findItemsAdvanced', {'keywords': 'Python'})
    print api.response_dict()
except ConnectionError as e:
    raise e

Sandbox Usage

from ebaysdk import finding
api = finding(domain='svcs.sandbox.ebay.com', appid="YOUR_APPID")
api.execute('findItemsAdvanced', {'keywords': 'Python'})
print api.response_dict()

Public Methods

finding(**kwargs)

Keyword arguments to finding() constructor

domain        -- API endpoint (default: svcs.ebay.com)
config_file   -- YAML defaults (default: ebay.yaml)
debug         -- debugging enabled (default: False)
errors        -- warnings enabled (default: True)
warnings      -- warnings enabled (default: False)
uri           -- API endpoint uri (default: /services/search/FindingService/v1)
appid         -- eBay application id
siteid        -- eBay country site id (default: EBAY-US)
compatibility -- version number (default: 1.0.0)
https         -- execute of https (default: False)
proxy_host    -- proxy hostname
proxy_port    -- proxy port number
timeout       -- HTTP request timeout (default: 20)
parallel      -- ebaysdk parallel object
response_encoding -- API encoding (default: XML)
request_encoding  -- API encoding (default: XML)

execute(verb, data)

Execute the HTTP request.

api.execute('findItemsAdvanced', {'keywords': 'Python'})

error()

Returns a string of the HTTP call errors

if api.error():
    print "has errors: %s" % api.error()

response_dom()

Return a DOM object (xml.dom.minidom) of the HTTP response content.

response_dict()

Return a dictionary of the HTTP response content.

response_content()

Returns the string content from HTTP response call.

response_soup()

Returns a BeautifulSoup object of the response

response_code()

Returns the HTTP response code.

response_status()

Returns the HTTP response status

response_codes()

Returns an array of eBay response codes

API Use Cases

  • Affiliate Tracking
  • Controlling the Way Search Results are Returned
  • Refining a Search with Aspect and Domain Filters
  • Refining a Search with Item Filters
  • Retrieving Histogram Metadata
  • Searching and Browsing by Category
  • Searching by Keywords
  • Searching by Product

see more

More Examples

see samples

Clone this wiki locally