documentcloud.py

import urllib, urllib2

try:
    import json
except ImportError:
    import simplejson as json

BASE_URL = "http://www.documentcloud.org/api/search.json?"

def search(q, page=1, sections=False, annotations=False):
    """
    Search for documents on DocumentCloud
    """
    params = {
        'q': q,
        'page': page,
        'sections': sections,
        'annotations': annotations
    }
    
    url = BASE_URL + urllib.urlencode(params)
    response = urllib2.urlopen(url)
    return json.loads(response.read())['documents']