Created: 2008-07-28 08:29
Updated: 2015-11-18 14:18

Overview is a wrapper around the Yahoo BOSS search service. It caches retrieved results and reuses them as much as possible. For example, you might retrieve results x[0:10], and later retrieve x[5:15]. It would reuse the previously cached results 5 through 9, and only retrieve 10 through 14. In that same vein, if you fetched x[10-20], and then tried to retieve 15, it would use a cached copy. also abstracts away the 50 result per query limit. Thus you can retrieve the first two hundred results x[:200] and it is smart enough to break that into four queries and combine the results. Note, however, that it still requires four queries, so it will be slower. However, if you first retrieved x[0:50] and then x[0:100], it would use the cached copy of 0-49, and only require one http request to fetch 50-99.

Imagined Usage

The purpose of is to simplify dealing with Yahoo BOSS search results. In particular it simplifies working with results by hand in the interpreter, but its simplicity and caching may be helpful in a variety of applications.


  1. Install the Yahoo BOSS Mashup framework.
  2. Create a config.json file in the directory you're running Python in (as detailed in the installation instructions for the Yahoo BOSS Mashup framework).


from boss_array import BossArray
x = BossArray("Python") # Here "Python" is your search term.
len(x) # to find the length
y = x[0:10] # fetches results 0-9
z = x[0:100] # has 0-9 cached, so fetches 10-99
a = x[50] # has 50 cached, so returns cached copy
for result in x[0:100]: # already has them cached, so no http request
    print result['url']
# open a url in a browser
import webbrowser[15]['url']) 
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more