Skip to content
This repository

Asynchronous Twitter REST/stream/search client API for node.js

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 LICENSE The big shift from twitter-node to node-twitter. October 17, 2010
Octocat-spinner-32 README.md
Octocat-spinner-32 index.js move more firmly away from node-twitter as npm/lib name December 23, 2010
Octocat-spinner-32 package.json
README.md

Asynchronous Twitter client API for node.js

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.

Version 0.2.0

Installation

You can install ntwitter and its dependencies with npm: npm install ntwitter.

Getting started

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.)

Setup API

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'
});

REST API

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));
        }
    );

Search API

twit.search('nodejs OR #node', function(err, data) {
    console.log(console.dir(data));
});

Streaming API

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);
});

Contributors

  • AvianFlu - Upgrades and current support
  • Jeff Waugh (primary author)
  • rick (parser.js and, of course, twitter-node!)

TODO

Something went wrong with that request. Please try again.