ntwitter is an upgraded version of jdub's node-twitter, which in turn was inspired by, and uses some code from, technoweenie's twitter-node.
You can install ntwitter and its dependencies with npm: npm install ntwitter
.
This library is, for the most part, the same API as node-twitter
. Much of the documentation below is straight from node-twitter
- credit goes to jdub for putting all this together in the first place.
The most significant API change involves error handling in callbacks. Callbacks should now look something like this:
function (err, result) {
if (err) {return callback(err)}
// Do something with 'result' here
}
Where callback
is the parent function's callback. (Or any other function you want to call on error.)
The keys listed below can be obtained from dev.twitter.com after setting up a new App.
var twitter = require('ntwitter');
var twit = new twitter({
consumer_key: 'Twitter',
consumer_secret: 'API',
access_token_key: 'keys',
access_token_secret: 'go here'
});
Note that all functions may be chained:
twit
.verifyCredentials(function (err, data) {
console.log(console.dir(data));
})
.updateStatus('Test tweet from ntwitter/' + twitter.VERSION,
function (err, data) {
console.log(console.dir(data));
}
);
twit.search('nodejs OR #node', function(err, data) {
console.log(console.dir(data));
});
The stream() callback receives a Stream-like EventEmitter:
twit.stream('statuses/sample', function(stream) {
stream.on('data', function (data) {
console.log(console.dir(data));
});
});
ntwitter also supports user and site streams:
twit.stream('user', {track:'nodejs'}, function(stream) {
stream.on('data', function (data) {
console.log(console.dir(data));
});
// Disconnect stream after five seconds
setTimeout(stream.destroy, 5000);
});
- AvianFlu - Upgrades and current support
- Jeff Waugh (primary author)
- rick (parser.js and, of course, twitter-node!)
- Complete the convenience functions, preferably generated
- Support recommended reconnection behaviour for the streaming APIs