Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including tweet-tweet with all npm packages installed. Try it out:

var tweetTweet = require("tweet-tweet")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

tweet-tweet v1.0.4

A no-nonsense api for posting tweets.


Build Status

A no-nonsense api for posting tweets.

This is only for updating your Twitter status. This does not get tweets, or stream search results.

Images and videos are not supported.


var TweetTweet = require('tweet-tweet')

var tweet = TweetTweet({
    consumerKey: '...',
    consumerSecret: '...',
    accessToken: '...',
    accessTokenSecret: '...'

tweet('Never teach someone how to cartwheel beside a lake. #lessonlearned')

setTimeout(function () {
    tweet('That awkward moment when you wake up... Said no one ever.')
}, 60 * 1000)


var TweetTweet = require('tweet-tweet')


If you don't know how to get the tokens and secrets from Twitter, see for detailed instructions.

  • auth is an object with the following properties, all of which are required:
    • consumerKey
    • consumerSecret
    • accessToken
    • accessTokenSecret
  • Returns tweet().

tweet(status, [cb])

  • status is a string or an object
    • If it is a string, it is the text of your status update.
    • If it is an object, it can have the parameters specified in the Twitter API under the Parameters section.
      • status - Required. The text of your status update. E.g. 'i love my cat. #cats'
      • in_reply_to_status_id - The ID of an existing status that the update is in reply to. Note that the author must be referenced in the status. E.g. '@twitter'
      • possibly_sensitive - If the tweet contains nudity, violence, etc. set this to true. Defaults to false.
  • cb(err, response) is an optional callback function. If no callback is given, errors will be thrown.
    • err is an Error object or null.
    • response is the parsed JSON response. See a sample response in the Twitter API under the Example Result section.
// Status string vs. status object
tweet('i like Twitter')
// Equivalent
tweet({ status: 'i like Twitter' })

// Setting parameters
    status: 'not for weak stomachs:',
    possibly_sensitive: true

    status: 'Happy birthday @twitter!',
    in_reply_to_status_id: '579328173764014080'

tweet('why is the sky blue?', function (err, res) {
    if (err) throw err
    else console.log(res)

    status: 'People comment "lol" even when they do not laugh.'
}, function (err, res) {
    if (err) throw err
    else console.log(res)


With npm do:

npm install tweet-tweet




RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free