Usage
=====

>>> from guardianapi import Client
>>> client = Client('my-api-key-goes-here')
>>> results = client.search(q = 'ocelots')
>>> results.count()
36
>>> for item in results:
...     print item['headline']

This will return the first ten results. To retrieve everything (by 
paginating across all pages automatically), do the following:

>>> for item in results.all():
...     print item['headline']

To access the filters for a result set:

>>> for filter in results.filters():
...    print filter

Some API responses include URLs to make further requests. Here's how to start
a request using a full API URL:

>>> url = results.filters()[0]['apiUrl']
>>> new_results = client.request(url)