Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

bindings for the Blekko search engine API

Project description

This module provides simple bindings to the Blekko API. To use the API, contact Blekko for an API key.

This module currently only supports search queries and page statistics. The API also provides tools for manipulating slashtags, but this library doesn’t support that yet.

The library is internally rate-limited to one query per second in accordance with Blekko’s guidelines.


To use the API, first create a Blekko object using your “source” or “auth” API key:

import blekko
api = blekko.Blekko(source='my_api_key')

Then, to perform searches, use the query method. Its arguments are the search terms (as a string) and, optionally, the page number:

results = api.query('peach cobbler')

The returned object is a sequence containing Result objects, which themselves have a number of useful fields:

for result in results:
    print result.url_title
    print result.url
    print result.snippet

Errors in communicating with the server are raised as BlekkoError exceptions, so you’ll want to handle these exceptions when making calls to the API.

An Example

Putting it all together, here’s a short script that gets a single link for search terms on the command line:

import blekko
import sys

_api = blekko.Blekko(source='my_api_key')

def get_link(terms):
        res = _api.query(terms + ' /ps=1')
    except blekko.BlekkoError as exc:
        print >>sys.stderr, str(exc)
        return None
    if len(res):
        return res[0].url

if __name__ == '__main__':
    link = get_link(' '.join(sys.argv[1:]))
    if link:

Page Statistics

Blekko provides an API for getting SEO-related statistics for a URL. Use the pagestats method, which takes a URL as its only parameter, to get a dictionary containing information about a page:

>>> api.pagestats('')
{u'cached': True, u'ip': u'', u'host_rank': 3835.107267,
u'host_inlinks': 467267, u'adsense': None, u'dup': True,
u'rss': u''}


These bindings were written by Adrian Sampson and modeled after the Perl bindings by Greg Lindahl. The source is made available under the MIT license.

Project details

Download files

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

Files for blekko, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size blekko-0.1.1.tar.gz (3.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page