Post, retrieve, and engage with Tweets

Please note:

We launched a new version of the standard statuses/lookup and statuses/show/:id endpoints as part of Twitter API v2: Early Access. If you are currently using any of these endpoints, you can use our migration materials to start working with the newer endpoint.

 

Overview

The following API endpoints can be used to programmatically create, retrieve and delete Tweets, Retweets and Likes:

Tweets Retweets Likes (formerly favorites)
  • POST statuses/update
  • POST statuses/destroy/:id
  • GET statuses/show/:id
  • GET statuses/oembed
  • GET statuses/lookup
  • POST statuses/retweet/:id
  • POST statuses/unretweet/:id
  • GET statuses/retweets/:id
  • GET statuses/retweets_of_me
  • GET statuses/retweeters/ids
  • POST favorites/create/:id
  • POST favorites/destroy/:id
  • GET favorites/list

For more details, please see the individual endpoint information within the API reference section.

Terminology

Tweet/Status - when a status message is shared on Twitter. Also see Introduction to Tweet JSON

Retweet - when a Tweet is re-shared by another specific user. Also see Introduction to Tweet JSON

Like - when a Tweet recieves a 'heart' from a specific user, formerly known as favo(u)rite or 'star'

 

Was this document helpful?

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.