node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org ยป


Twitter tweets to command arguments

[tweet-bliss] Aims to provide a simplified, asynchronous client by providing only the basic uses and abstracting away the complexity of the entire API

  • Uses version 1.1 of Twitter's REST and Streaming APIs

  • See examples directory for example usage


npm install tweet-bliss


You can install tweet-bliss and its dependencies with npm: npm install tweet-bliss.

Getting started

  1. Head over to and create an account and an app.

  2. On your app page click settings and set application type to Read, Write and Access direct messages

  3. Create access token

  4. On the OAuth tool tab you can view your keys and secrets for use below

Setup API (stable)

var bliss = require('tweet-bliss').createClient({
	access_token_key: 'XXXXXXXXXXXXXXXXXXXXXX',
	access_token_secret: 'XXXXXXXXXXXXXXXXXXXXXX'

Basic Streaming tweets by keyword'#add', null, function(fromUserName, tweetText){
	//handle tweets that contain #add

Basic Streaming tweets by userID (to get userid of user use, "942738733", function(fromUserName, tweetText){
	//handle tweets that contain #add

Basic tweeting (returns promise)

	//tweet has been sent