Skip to main content

Simple wrapper around the Yahoo Boss API (

Project description

Simple Wrapper Around the Yahoo Boss Search API



Base class. Should not be called directly.


Use PlaceFinder to locate an address or place


from yahooboss import PlaceFinder

pf = Placefinder(your_key,your_secret)
results = pf.placefinder( 'Address or Place Name' )
latitude = results[0].get('latitude')
longitude = results[0].get('longitude')


__init__( key, secret )

Extends YahooBoss, returns a PlaceFinder object


  • key- YahooBoss oAuth key.
  • secret - YahooBoss oAuth secret

placefinder( place )

Accepts an address or place name and returns a validated address and geocode


  • place - Address or place name

Returns dict

        "count": "1",
        "start": "0",
        "request": "count=1&flags=J&q=2435%2BN.%2BCentral%2BExpressway%252C%2BRichardson%2BTX%2B75080",
        "results": [
                        "neighborhood": "",
                        "house": "2435",
                        "county": "Dallas County",
                        "street": "N Central Expy",
                        "radius": "400",
                        "quality": "87",
                        "unit": "",
                        "city": "Richardson",
                        "countrycode": "US",
                        "woeid": "12790359",
                        "xstreet": "",
                        "line4": "United States",
                        "line3": "",
                        "line2": "Richardson, TX 75080-2717",
                        "line1": "2435 N Central Expy",
                        "state": "Texas",
                        "latitude": "32.98529",
                        "hash": "4289EC860C737D3F",
                        "unittype": "",
                        "offsetlat": "32.985249",
                        "statecode": "TX",
                        "postal": "75080-2717",
                        "name": "",
                        "uzip": "75080",
                        "country": "United States",
                        "longitude": "-96.711983",
                        "countycode": "",
                        "offsetlon": "-96.713814",
                        "addressmatchtype": "POINT_ADDRESS",
                        "woetype": "11"


Use BossSearch to search the web or news articles


from yahooboss import BossSearch
bs = BossSearch(your_key, your_secret)

web_results = bs.search_web( 'search parameters' )

for wr in web_results:
        print 'Title: %s' % wr.get('title')
        print 'Summary: %s' % wr.get('abstract')
        print 'URL: %s' % wr.get('url')

news_results = bs.search_news( 'search parameters' )

for r in news_results:
        print 'Title: %s' % r.get('title')
        print 'Summary: %s' % r.get('abstract')
        print 'Source: %s' % r.get('source')
        print 'Date: %s' % r.get('date')
        print 'URL: %s' % r.get('url')


__init__(key, secret, **kwargs)

Extends YahooBoss, returns a BossSearch object


  • key - YahooBoss oAuth key
  • secret - YahooBoss oAuth secret

Keyword arguments:

  • age - Max age of the results (e.g. “7d”. See the Search BOSS documentation for a complete list)
  • urls - list of urls to search. (Can be partial urls, see the BOSS documentation)
  • results_per_page - number of results per page (or per request)

search_web(query, page_num=1)

Searches the web for the specified query and returns a list of results


  • query - the query string to search for
  • page_num - start at page (default: 1)

Returns a list of dict results:

        "dispurl": "<b>Yoda</b>",
        "title": "<b>Yoda</b> - Wookieepedia, the Star Wars Wiki",
        "url": "",
        "abstract": "<b>Yoda</b> was one of the most renowned and powerful Jedi Masters in galactic history. He was known for his legendary wisdom, mastery of the Force and skills in lightsaber ...",
        "clickurl": "",
        "date": ""


Search Yahoo News for the specified query

Arguments: - query - string to search for - page_num - start at page (default: 1)

Returns a list of dict results:

        "sourceurl": "",
        "language": "en english",
        "title": "Ferguson Library Becomes Oasis of Calm Amid Strife",
        "url": "",
        "abstract": "Ferguson library has become an oasis of calm and activities for children while school postpone during the street protests over the police shooting of Michael Brown.",
        "clickurl": "",
        "source": "ABC News",
        "date": "1408554014"

make_request(bucket, query, page_num)

Used internally to make a raw request to YahooBoss services. Can be used to make a request to one of the services not currently covered by a wrapper function.


  • bucket - yahoo service bucket (e.g. “news”)
  • query - query string to search
  • page_num - page to start at

Returns a list of dicts. The structure of the dict depends on the return value from Yahoo


The module currently does not support Yahoo’s “LimitedWeb”, “Images”, “Spelling” or “Related Search”.

These can be requested via the BossSearch.make_request method


ConstituentVoice -

Project details

Release history Release notifications

History Node


This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
YahooBoss-Python-0.1.5.tar.gz (5.3 kB) Copy SHA256 hash SHA256 Source None Sep 5, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page