Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Python library for OAuth 1.0/a, 2.0, and Ofly.
Python Makefile

Merge pull request #175 from HenriChataing/master

Allow optional query parameters
latest commit d285e263d6
Max Countryman maxcountryman authored
Failed to load latest commit information.
docs Fix typo: `sesssion` -> `session`
examples python 3 support
rauth Allow optional query parameters
tests Merge pull request #147 from cesarware/master
.gitignore python 3 support
.gitmodules using updated theme
.travis.yml python 3 support expose auth responses
CHANGELOG version 0.7.1
LICENSE webauth->rauth python 3 support
Makefile python 3 support python 3 support
requirements-dev@2.6.txt prepare for requests 2.0.0.
requirements.txt prepare for requests 2.0.0. python 3 support prepare for requests 2.0.0.
tox.ini python 3 support


A simple Python OAuth 1.0/a, OAuth 2.0, and Ofly consumer library built on top of Requests.

build status


  • Supports OAuth 1.0/a, 2.0 and Ofly
  • Service wrappers for convenient connection initialization
  • Authenticated session objects providing nifty things like keep-alive
  • Well tested (100% coverage)
  • Built on Requests (v1.x)


To install:

$ pip install rauth

Or if you must:

$ easy_install rauth

Example Usage

Let's get a user's Twitter timeline. Start by creating a service container object:

from rauth import OAuth1Service

# Get a real consumer key & secret from
twitter = OAuth1Service(

Then get an OAuth 1.0 request token:

request_token, request_token_secret = twitter.get_request_token()

Go through the authentication flow. Since our example is a simple console application, Twitter will give you a PIN to enter.

authorize_url = twitter.get_authorize_url(request_token)

print 'Visit this URL in your browser: ' + authorize_url
pin = raw_input('Enter PIN from browser: ')  # `input` if using Python 3!

Exchange the authorized request token for an authenticated OAuth1Session:

session = twitter.get_auth_session(request_token,
                                   data={'oauth_verifier': pin})

And now we can fetch our Twitter timeline!

params = {'include_rts': 1,  # Include retweets
          'count': 10}       # 10 tweets

r = session.get('statuses/home_timeline.json', params=params)

for i, tweet in enumerate(r.json(), 1):
    handle = tweet['user']['screen_name']
    text = tweet['text']
    print(u'{0}. @{1} - {2}'.format(i, handle, text))

Here's the full example: examples/


The Sphinx-compiled documentation is available here:


Anyone who would like to contribute to the project is more than welcome. Basically there's just a few steps to getting started:

  1. Fork this repo
  2. Make your changes and write a test for them
  3. Add yourself to the AUTHORS file and submit a pull request!

Note: Before you make a pull request, please run make check. If your code passes then you should be good to go! Requirements for running tests are in requirements-dev@<python-version>.txt. You may also want to run tox to ensure that nothing broke in other supported environments, e.g. Python 3.

Copyright and License

Rauth is Copyright (c) 2013 litl, LLC and licensed under the MIT license. See the LICENSE file for full details.

Something went wrong with that request. Please try again.