Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

97 lines (65 sloc) 2.966 kB

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


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)}
   // Real code goes here

Where callback is the parent function's callback method. (Or any other function you want to call on error, really.)

Setup API (stable)

The keys listed below can be obtained from here

var twitter = require('ntwitter');
var twit = new twitter({
    consumer_key: 'STATE YOUR NAME',
    consumer_secret: 'STATE YOUR NAME',
    access_token_key: 'STATE YOUR NAME',
    access_token_secret: 'STATE YOUR NAME'

Basic OAuth-enticated GET/POST API (stable)

The convenience APIs aren't finished, but you can get started with the basics:

twit.get('/statuses/show/27593302936.json', {include_entities:true}, function(data) {

REST API (unstable, may change)

Note that all functions may be chained:

    .verifyCredentials(function (data) {
    .updateStatus('Test tweet from ntwitter/' + twitter.VERSION,
        function (data) {

Search API (unstable, may change)'nodejs OR #node', function(data) {

Streaming API (stable)

The stream() callback receives a Stream-like EventEmitter:'statuses/sample', function(stream) {
    stream.on('data', function (data) {

ntwitter also supports user and site streams:'user', {track:'nodejs'}, function(stream) {
    stream.on('data', function (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!)


Jump to Line
Something went wrong with that request. Please try again.