skip to navigation
skip to content

Not Logged In

diffbot 1.1.2

Python client for the Diffbot API.

Bitdeli Build Status Coverage Status Version Downloads

How to use it:

>>> import diffbot
>>> json_result = diffbot.article('', token='…')

The above simple example is a shortcut for using the diffbot.Client class.

>>> import diffbot
>>> client = diffbot.Client(token='…')
>>> json_result = client.article('')

The above calls are shortcuts for using the diffbot.api() function and the diffbot.Client.api method:

>>> import diffbot
>>> client = diffbot.Client(token='…')
>>> json_result = client.api('article', '')

To POST data (text or HTML) to the API, use the text or html arguments:

>>> import diffbot
>>> client = diffbot.Client(token='…')
>>> json_result = client.api('article', '', html='''
... <h1>Introducing GitHub Traffic Analytics</h1>
... <p>We want to kick off 2014 with a bang, so today we're happy to launch
... traffic analytics!</p>
... ''')

Command line interface:

$ python -h
usage: [-h] [-a] [-f FILE] api url token

positional arguments:
  api                   API to call. One one of 'article', 'frontpage',
                        'product', 'image' or 'analyze'.
  url                   URL to pass as the 'url' parameter.
  token                 API key (token). Get one at

optional arguments:
  -h, --help            show this help message and exit
  -a, --all             Request all fields.
  -f FILE, --file FILE  File to read data from. Use '-' to read from STDIN.

$ python article TOKEN

Output of the above example:

  "icon": "",
  "sections": [
  "title": "Build software better, together.",
  "url": ""


  • Python 2+3 support
  • Google App Engine support
  • Requests support (but no dependency)
  • CI + 100% test coverage
  • Passes pyflakes, pep8, flake8, pylint score 10/10
  • Simple & small (1 file, ~100 LOC)
  • Command line interface
File Type Py Version Uploaded on Size
diffbot-1.1.2.tar.gz (md5) Source 2014-02-20 4KB
  • Downloads (All Versions):
  • 45 downloads in the last day
  • 247 downloads in the last week
  • 599 downloads in the last month