Description
A Twitter Node Module to authenticate and interact with the Twitter REST API from NodeJS.
Installation
npm install twitter-node-client
var Twitter = require('twitter-node-client').Twitter;
Usage
You need to create a Twitter app to use the API.
//Callback functions
var error = function (err, response, body) {
console.log('ERROR [%s]', err);
};
var success = function (data) {
console.log('Data [%s]', data);
};
var Twitter = require('twitter-node-client').Twitter;
//Get this data from your twitter apps dashboard
{
"consumerKey": "XXX",
"consumerSecret": "XXX",
"accessToken": "XXX",
"accessTokenSecret": "XXX",
"callBackUrl": "XXX"
}
// make a directory in the root folder of your project called data
// copy the node_modules/twitter-node-client/twitter_config file over into data/twitter_config`
// Open `data/twitter_config` and supply your applications `consumerKey`, 'consumerSecret', 'accessToken', 'accessTokenSecret', 'callBackUrl' to the appropriate fields in your data/twitter_config file
var twitter = new Twitter();
//Example calls
twitter.getUserTimeline({ screen_name: 'BoyCook', count: '10'}, error, success);
twitter.getMentionsTimeline({ count: '10'}, error, success);
twitter.getHomeTimeline({ count: '10'}, error, success);
twitter.getReTweetsOfMe({ count: '10'}, error, success);
twitter.getTweet({ id: '1111111111'}, error, success);
//
// Get 10 tweets containing the hashtag haiku
//
twitter.getSearch({'q':'#haiku','count': 10}, error, success);
//
// Get 10 popular tweets with a positive attitude about a movie that is not scary
//
twitter.getSearch({'q':' movie -scary :) since:2013-12-27', 'count': 10, 'result\_type':'popular'}, error, success);
Twitter has a comprehensive REST api if you need to use something that doesn't have a wrapper function in the library call it directly :
twitter.getCustomApiCall('/statuses/lookup.json',{ id: '412312323'}, error, success);
twitter.postCustomApiCall('/direct_messages/new.json',{user_id: '1234', 'text':'This is easy.'}, error, success);
To get the list of expected parameters and results, check https://dev.twitter.com/rest/public
Functions
Docs
Search Tweets.To learn how to use Twitter Search effectively read Using the Twitter Search API
twitter.getSearch(parameters, errorCallback, successCallback);
Docs
Update user's status (Tweet). twitter.postTweet(parameters, errorCallback, successCallback);
Docs
Follow another user by user_id or screen_name(handle). twitter.postCreateFriendship(parameters, errorCallback, successCallback);
Docs
Get a user's timeline twitter.getUserTimeline(parameters, errorCallback, successCallback);
Docs
Get the latest 20 recent mentions for the authenticating user. twitter.getMentionsTimeline(parameters, errorCallback, successCallback);
Docs
Get the latest tweets and retweets by the authenticating users and the ones they follow. twitter.getHomeTimeline(parameters, errorCallback, successCallback);
Docs
Get latest retweets of authenticated user. twitter.getReTweetsOfMe(parameters, errorCallback, successCallback);
Docs
Get a tweet by id. twitter.getTweet(parameters, errorCallback, successCallback);
Docs
Get information about a user by user_id or handle (screen_name). twitter.getUser(parameters, errorCallback, successCallback);
Docs
Get a cursored collection of the followers of a user_id or a handle (screen_name). twitter.getFollowersList(parameters, errorCallback, successCallback);
Docs
Get a cursored collection of the followers' ids of a user_id or a handle (screen_name). twitter.getFollowersIds(parameters, errorCallback, successCallbackok);
Docs
Upload media (images) to Twitter. twitter.postMedia(parameters, errorCallback, successCallback);
Tests
There is a test file TwitterITSpec.js
that does a basic integration tests of the client.
It uses a properties file test/spec/properties.json
to inject in the OAuth properties.
These will need to be updated with your own details before the tests will run
Running tests
make test