Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Simple, standardized OAuth signature generator
PHP JavaScript Perl Python HTML Perl6 Makefile
Branch: master



OAuthSimple - a very simple OAuth 1.0 signed request generator


See source comments for usage examples


OAuthSimple aids in building valid OAuth 1.0 requests. It does not perform token requests by itself, however you can use it to build the request calls.

I've tried to build the library to be fairly common so that if you're familiar with how it works in one language, you can use it in any other. Right now the following languages are supported: PHP, Javascript, Perl, Python. I'd love to add additional languages and may do so in the future. (I'd be happy to accept contributions, hint, hint.)

Guido Schlabitz has provided a useful example for how to use OAuthSimple to connect to Google

Dave Bagler has provided a Composer Package His fork has more details:

OAuthSimple accepts arguments in a variety of formats and returns a structure containing valid elements, including a fully structured URL, an Authorization header and the signature value. You should only use either the Authorization Header (as per the spec), or the fully structured URL. (Again, see source comments for appropriate usage.)

Please note that the Javascript version is not heavily optimized at this time. If you wish to use a more optimized version, please consult Anton Byrna's fork

OAuth Developers may be interested in my OAuthTestPage at: This will display OAuth1a valid elements and values so you can verify things are working correctly. =head1 EXAMPLES

Node.js Installation

    > npm install oauthsimple

Node.js Example

    OAuthSimple = require('OAuthSimple')
    oauth = new OAuthSimple("token", "secret")
    request = oauth.sign({
      action: "GET",
      path: "",
      parameters: { term: 'DeNiro' }

    // then use any library to request the following url


Code is released under a BSD licence.

Something went wrong with that request. Please try again.