/disqus-python

Disqus API bindings for Python

Primary LanguagePythonApache License 2.0Apache-2.0

disqus-python

https://travis-ci.org/disqus/disqus-python.svg?branch=master

Let's start with installing the API:

pip install disqus-python

Use the API by instantiating it, and then calling the method through dotted notation chaining:

from disqusapi import DisqusAPI
disqus = DisqusAPI(secret_key, public_key)
for result in disqus.get('trends.listThreads'):
    print result

Parameters (including the ability to override version, api_secret, and format) are passed as keyword arguments to the resource call:

disqus.get('posts.details', post=1, version='3.0')

Paginating through endpoints is easy as well:

from disqusapi import Paginator
paginator = Paginator(api.get, 'trends.listThreads', forum='disqus')
for result in paginator:
    print result

# pull in a maximum of 500 results (this limit param differs from the endpoint's limit param)
for result in paginator(limit=500):
    print result

Documentation on all methods, as well as general API usage can be found at https://disqus.com/api/docs/