ebSear

The unofficial Ebay search CLI & API. Search ebay on the command line for free without the need for an API key or any additional setup.

$ ebsear 'Air conditioner'

     Name                                                     Price      Form/Bids
1    Daikin Air Conditioner Wi-Fi Online Controller BRP069A4  $62.90     Buy It Now
2    DC 12V Peltier Semiconductor Refrigeration Pet Air Cond  $14.12     Buy It Now
3    Portable Personal Amazing Air Conditioner Natural Wind   $88.50     Buy It Now
4    Haier 8,000 BTU Electronic Window Air Conditioner AC Un  $199.99    Buy It Now
5    AIR  COND VACUUM PUMP MANIFOLD GAUGE  RATCHED FLARING P  $387.30    Buy It Now
6    Fin Comb For Air Conditioner Blade Cooling Straightenin  $2.79      Buy It Now
7    Daikin Air Conditioner Wi-Fi Online Controller BRP069A4  $61.90     Buy It Now
8    **GENUINE** Air Conditioner Remote Control - Airwell Em  $182.40    Buy It Now
9    New Portable Mute Length 38CM Height 73.6CM Humidifier   $270.88    or Best Offer
10   ACTRON DUCTED AIR CONDITIONER CONTROLLER LEASOM B512GZ   $387.30    Buy It Now
11   Heigth 57CM Portable Evaporative Air Cooler Fan Humidif  $239.83    or Best Offer
12   12,000 BTU 14SEER 1TON Ductless Mini Split Air Conditio  $649.00    or Best Offer
13   24,000 BTU 2TON  Ductless Mini Split Air Conditioner  1  $999.00    Buy It Now
14   24,000 BTU 2TON  Ductless Mini Split Air Conditioner  1  $1,199.00  Buy It Now
15   AC AIR CON WATER CONDENSATE MINI DRAIN PUMP MICRO V AQU  $213.44    Buy It Now
16   LG KELVINATOR AIR CONDITIONER MAIN BOARD  P/N 129091218  $256.13    Buy It Now
17   AIR CONDITIONER DUST PAINT  ROOM FILTER MATERIAL  1x20m  $232.07    Buy It Now
18   18000 BTU 1.5TON  Ductless Mini Split Air Conditioner    $899.00    Buy It Now
19   AIR CONDITIONER TUBE 1/4" 3/8" INSULATED  COPPER PIPE T  $135.83    Buy It Now
20   FUJITSU AOTR09LCC INVERTER OUTDOOR PCB K05CS-05          $349.27    or Best Offer
21   Capacity 7L Portable Evaporative Air Cooler Fan Humidif  $263.11    or Best Offer
22   AIR CONDITIONING AC AIR CON WATER CONDENSATE TANK DRAIN  $89.65     Buy It Now
23   New Portable Mute Length 28.5CM Height 70CM Humidifier   $263.11    or Best Offer
24   18000 BTU 1.5TON  Ductless Mini Split Air Conditioner    $849.00    Buy It Now
25   Portable Mute Length 30.5CM Height 75.5CM Humidifier Pu  $224.31    or Best Offer
...										...									...

Installation

Can easily be be run on Python version 2.7 or greater with minimal additional dependencies (works best on Python3).

Install the dependencies and main package using pip.

$ pip install ebsear

Usage

CLI

Typing ebsear without any additionaly arguments will display the folllowing usage information:

Usage: ebsear query_string [-p num] [-i num] [-u url] [-q] [-v] [-d]

Optional Paratmeters

• -p num - Specify the page number to search (defaults to -p 1)
• -i num - Select the number item to display (relative to the page number)
• -q - Disable any printout from occuring on the command line
• -v - Display all information scraped (json lines)
• -d - Disable the page from opening in your default web browser
• -u - Use an alternate base url (for searches on international ebay sites)

Examples

$ ebsear 'air conditioner' -p 5

Display the fifth page in the search

$ ebsear 'air conditioner' -i 2

Display the second item in the search

$ ebsear 'air conditioner' -i 2 -v

Display the second item in the search in a json format

$ ebsear 'air conditioner' -i 2

Display the fifth item in the search

$ ebsear 'air conditioner' -u 'ebay.co.uk'

Display the first page in the search using "ebay.co.uk"

$ ebsear 'air conditioner' -d

Display the first page in the search and restrain the page from automatically opening in browser

API

The API can be used to make an ebay search query whilst inside a Python script. The main methods getSearchPage and getItem are the best entry points to use for such cases. These methods will return a tuple of the products (or product) as well as a url to access either the search page (for a search query) or the item page (for a single item query). The products returned from these methods are cleansed and returned in a dictonary containing both the original data and the cleansed data.

>>> from ebsear import api
>>> (products,url) = api.getSearchPage('air conditioner',page_num=1)
>>> pprint.pprint(products[1])
{'format': 'Buy It Now',
 'name': 'Daikin Air Conditioner Wi-Fi Online Controller BRP069A43',
 'price': {'text': '$62.90', 'values': [62.9]},
 'shipping': {'text': 'Free international shipping', 'values': [0]},
 'subtitle': 'Brand New',
 'url': 'http://www.ebay.com/itm/Daikin-Air-Conditioner-Wi-Fi-Online-Controller-BRP069A43-/282634166527?epid=15003634367&hash=item41ce4f20ff:g:~yMAAOSwLEtYhMsW'}

About

The idea and implementation for this library was an augmentation of a previous library by the same developer - amzSear.

This library was designed to facilitate the use of an easy command line tool to search ebay.com. The developer does, however, utilise the ebay affiliate program to track usage of this software and to monetise this and other publicly accessible projects.