google Image search API

A python client to query image from google. Though the api service has been tagged as (Deprecated), it will work before a new version is released.

'''
Loosely based on Mike Verdone's excellent twitter library: http://github.com/sixohsix/twitter/ 
'''

from exceptions import Exception
from urllib import urlencode
import urllib2

try:
import json
except ImportError:
import simplejson as json

class GoogleError(Exception):
"""
Exception thrown by the search object when there is an
error interacting with google.com.
"""
pass

class GoogleImageSearch(object):
def __init__(self, endpoint, user_agent= None, cache=None):
self.endpoint = endpoint
self.cache = cache
self.user_agent = user_agent

def __call__(self, **params):
params['v']='1.0'
kwargs = dict(params)
kwargs = urlencode(kwargs)

# HTTP GET
req = urllib2.Request('%s?%s' % (self.endpoint, kwargs))
print req.get_full_url()
cache_response = True

if self.user_agent:
req.add_header('User-Agent', self.user_agent)

try:
handle = urllib2.urlopen(req)
response = handle.read()
if cache_response and self.cache != None:
self.cache.set('googleimagesearch-' + kwargs, response, time=int(time() + 60))
response = json.loads(response)
return response
except urllib2.HTTPError, e:
raise GoogleError('google imagesearch sent status %i for method: %s\ndetails: %s' % (e.code, e.fp.read()))

class GoogleImage(GoogleImageSearch):
def __init__(self, endpoint='https://ajax.googleapis.com/ajax/services/search/images', user_agent='python-googleimage/0.1',  cache=None):
GoogleImageSearch.__init__(self, endpoint=endpoint, user_agent=user_agent,  cache=cache)

if __name__ == '__main__':
googleimage =  GoogleImage()
query = {'q':'EURECOM'}
print googleimage(**query)