tweet-tweet

A no-nonsense node module 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.

example

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)

api

var TweetTweet = require('tweet-tweet')

TweetTweet(auth)

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

• auth is an object with consumerKey, consumerSecret, accessToken, and accessTokenSecret properties
• 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.
    • 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 swallowed.
  • 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
tweet({
	status: 'not for weak stomachs: http://emergency-room-pictures.com',
	possibly_sensitive: true
})

tweet({
	in_reply_to_status_id: '579328173764014080',
	// https://twitter.com/Twitter/status/579328173764014080
	status: 'Happy birthday @twitter!'
	// Since the status that is being replied to is from the @twitter
	// account, then "@twitter" must be included in the status
})

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

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

install

With npm do:

npm install tweet-tweet

license

MIT