Overview

== py-diffbot ==

py-diffbot is a command line terminal client and python library for the [[http://www.diffbot.com/|Diffbot]] article extraction and analysis API.

=== Developer Token ===

To use the client or Python library you will need to include a developer token, which can be obtained by submitting a request at the Diffbot website.

[[http://www.diffbot.com/docs/token]]

=== Getting Source ===

{{{ $ hg clone http://bitbucket.org/nik/py-diffbot/ diffbot }}}

=== Command Line Client ===

{{{ $ cd diffbot $ chmod +x diffbot.py $ ./diffbot.py }}}

Command line options:

{{{ $ ./diffbot.py Usage: diffbot.py: [options] [url]

Options:
-h, --help show this help message and exit

-d, --debug -v, --verbose -q, --quiet -o OFORMAT, --output=OFORMAT

Ouput format (html, raw, json, pretty)
-k KEY Diffbot developer API key

}}}

=== Library Integration ===

{{{ $ hg clone http://bitbucket.org/nik/py-diffbot/ diffbot }}}

Then link it to your source tree so that it can be imported:

{{{ $ ln -s diffbot/diffbot /my/project/vendors/diffbot }}}

Simple code to get you started:

{{{ #!python

import diffbot

def main(url):
db = diffbot.DiffBot(dev_token = "mydevtoken") article = db.get_article(url)

}}}

=== Links and Resources ===