Recently Updated Documentation

October 22, 2012
Document Description
Streaming message types Public stream messages Blank lines Status deletion notices (delete) Location deletion notices (scrub_geo) Limit notices (limit) Withheld content notices (status_withheld, user_withheld) Disconnect messages (disconnect) User stream messages Friends lists (friends) Events (event...
October 20, 2012
Document Description
Embedded Timelines Overview Embeddable timelines make it easy to syndicate any public Twitter timeline to your website with one line of code. Just like timelines on twitter.com, embeddable timelines are interactive and enable your visitors to reply, Retweet, and favorite Tweets directly from your pages. Users...
October 19, 2012
Document Description
iOS Twitter framework Overview Go to the source What can I do with the framework? Single Sign-On Distribution Instant Personalization Accessing the Twitter API Have questions? Overview Apple includes a framework that enables your iOS applications to leverage the power of Twitter. This framework removes...
Why am I getting a HTTP 404 for my timeline feed? If you're requesting a timeline URL that used to work but now does not, you are likely using an outdated URL that has been retired. In March of 2012 we announced that "unversioned endpoints," GET statuses/public_timeline, and the v1 REST ATOM response format were deprecated and would eventually...
October 18, 2012
Document Description
GET direct_messages Returns the 20 most recent direct messages sent to the authenticating user. Includes detailed information about the sender and recipient user. You can request up to 200 direct messages per call, up to a maximum of 800 incoming DMs. Important: This method requires an access token with RWD (read,...
POST statuses/update Updates the authenticating user's current status, also known as tweeting. To upload an image to accompany the tweet, use POST statuses/update_with_media. For each update attempt, the update text is compared with the authenticating user's recent tweets. Any attempt that would result in duplication...
October 16, 2012
Document Description
Twitter Cards Introduction Twitter cards make it possible for you to attach media experiences to Tweets that link to your content. Simply add a few lines of HTML to your webpages, and users who Tweet links to your content will have a "card" added to the Tweet that’s visible to all of their followers. We are...
October 15, 2012
Document Description
GET statuses/user_timeline Returns a collection of the most recent Tweets posted by the user indicated by the screen_name or user_id parameters. User timelines belonging to protected users may only be requested when the authenticated user either "owns" the timeline or is an approved follower of the owner. The timeline...
GET lists/statuses Returns tweet timeline for members of the specified list. Historically, retweets were not available in list timeline responses but you can now use the include_rts=true parameter to additionally receive retweet objects.
POST account/settings Updates the authenticating user's settings.
October 12, 2012
Document Description
Users Users can be anyone or anything. They tweet, follow, create lists, have a home_timeline, can be mentioned, and can be looked up in bulk. (JSON) Field Guide Consumers of Users should tolerate the addition of new fields and variance in ordering of fields with ease. Not all fields appear in all...
GET statuses/retweets_of_me Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
GET statuses/retweeted_to_me Returns the 20 most recent retweets posted by users the authenticating user follow. A maximum of 200 tweets will be available on this timeline.
GET statuses/retweeted_by_me Returns the 20 most recent retweets posted by the authenticating user.
GET statuses/home_timeline Returns the most recent statuses, including retweets if they exist, posted by the authenticating user and the users they follow. This is the same timeline seen by a user when they login to twitter.com. This method is identical to statuses/friends_timeline, except that this method always includes...
GET statuses/user_timeline Returns the 20 most recent statuses posted by the authenticating user. It is also possible to request another user's timeline by using the screen_name or user_id parameter. The other users timeline will only be visible if they are not protected, or if the authenticating user's follow request was...
GET users/lookup Returns fully-hydrated user objects for up to 100 users per request, as specified by comma-separated values passed to the user_id and/or screen_name parameters. This method is especially useful when used in conjunction with collections of user IDs returned from GET friends/ids and GET followers/...
October 9, 2012
Document Description
GET statuses/public_timeline This method has been removed from service. Please use GET statuses/sample instead for obtaining recent public tweets. Returned the 20 most recent statuses, including retweets if they existed, from non-protected users. The public timeline was cached for 60 seconds. Requesting more frequently than...
Tweets Also known as a Status Update, Tweets are the basic atomic unit of all things Twitter. Users create Tweets. Tweets can be embedded, replied to, favorited, unfavorited, retweeted, unretweeted and deleted. A retweet contains an embedded Tweet object within the "retweeted_status" attribute....
October 8, 2012
Document Description
Error Codes & Responses HTTP Status Codes The Twitter API attempts to return appropriate HTTP status codes for every request. It is possible to suppress response codes for the REST API. Code Text Description 200 OK Success...