Simple module for using Twitter's API in node.js
npm install node-twitter-api
var twitterAPI = ;var twitter =consumerKey: 'your consumer Key'consumerSecret: 'your consumer secret'callback: '';
Optionally you can add
x_auth_access_type: "read" or
x_auth_access_type: "write" (see: https://dev.twitter.com/oauth/reference/post/oauth/request_token).
### Step 2: Getting a request token ###
If no error has occured, you now have a
requestToken and a
requestTokenSecret. You should store them somewhere (e.g. in a session, if you are using express), because you will need them later to get the current user's access token, which is used for authentification.
Redirect the user to
twitter.getAuthUrl(requestToken, options) also returns that URL (the options parameter is optional and may contain a boolean
force_login and a String
screen_name - see the Twitter API Documentation for more information on these parameters).
If he allows your app to access his data, Twitter will redirect him to your callback-URL (defined in Step 1) containing the get-parameters:
oauth_verifier. You can use
oauth_token (which is the
requestToken in Step 2) to find the associated
requestTokenSecret. You will need
oauth_verifier to get an Access Token.
If no error occured, you now have an
accessToken and an
accessTokenSecret. You need them to authenticate later API-calls.
In the above example,
params is an optional object containing extra parameters to be sent to the Twitter endpoint (see https://dev.twitter.com/rest/reference/get/account/verify_credentials)
(Allmost) all function names replicate the endpoints of the Twitter API 1.1. If you want to post a status e. g. - which is done by posting data to statuses/update - you can just do the following:
Most of the functions use the scheme:
twitter.[namespace]([type], [params], [accessToken], [accessTokenSecret], [callback]);
For Timelines you can also use the function getTimeline which has the following types:
user_timeline(Note that you need to either specify user_id or screen_name when using this timeline)
For more information on the different types of timelines see https://dev.twitter.com/rest/reference/get/statuses/home_timeline (analog for the other types)
For Streams you must use getStream which has two instead of just one callback: a dataCallback and an endCallback. (c.f. data and end events of node's http response)
To upload media to Twitter, call
twitter.uploadMedia(params, accessToken, accessTokenSecret, callback) with params containing the following:
To upload video to Twitter, call
twitter.uploadVideo(params, accessToken, accessTokenSecret, callback) with params containing the following:
You can pass media_id to the statuses/update endpoint and video will be uploaded to twitter. Please note that video should be less than 15mb or 30 sec in length.