Recently Updated Documentation

May 21, 2012
Document Description
How do I properly navigate a timeline? The Working with Timelines document describes the optimal way to obtain tweets from timelines such as GET statuses/home_timeline, GET statuses/mentions and GET statuses/user_timeline. The "count" parameter behaves more closely in concept to an "up to" parameter in that you'll receive up to the...
May 18, 2012
Document Description
How do I count retweets? Tweets in the REST and Streaming APIs contain a field called retweet_count that provides the number of times that tweet has been retweeted. You can obtain the retweet count for any arbitrary tweet by using GET statuses/show/:id. You can count retweets as they happen by using a The Streaming APIs....
How do I count favorites? Favorite counts aren't available as part of tweet objects in the REST, Streaming or Search APIs at this time. User streams and Site streams both stream events when an authenticated user favorites tweets or has their tweets favorited. Using these authenticated streaming APIs, you can count...
I don't want to require users to authenticate but 150 requests per hour is not enough for my app, what should I do? Rethink not wanting to require authentication. It's the primary means to grow your application's capabilities. We recommend requiring authentication to make use of potentially 350 requests per hour per access token/user. Consider also investigating whether the Streaming API's follow filter...
How do password resets effect application authorization? When using OAuth, application connectivity and permissions do not change when a user resets their password on twitter.com. The relationship between Twitter, a user, and a third-party application do not involve a username and password combination. When a Twitter user changes their password, we'll...
Site streams Overview Endpoint Protected data Connecting Limits Best Practices Be familiar with User Streams Modifying streams Applying for access Overview Site Streams allows services, such as web sites or mobile push services, to receive real-time updates for a large number of users...
User streams Overview Endpoint Connections User streams messages Data from accounts the user follows Replies Direct messages Best practices User streams and the REST API Filtering Tweets for display Overview User Streams provide a stream of data and events specific to the...
How do I keep from running into the rate limit? Caching. We recommend that you cache API responses in your application or on your site if you expect high-volume usage. For example, don't try to call the Twitter API on every page load of your hugely popular website. Instead, call our API once a minute and save the response to your local server,...
What's the difference between User Streams and Site Streams? User streams provides a way for a single user to be streamed the equivalent of their home timeline (the tweets authored by the users they follow) and mentions timeline (the tweets authored by users @mentioning that user). It also offers the ability to be streamed DMs received by the user when...
How do I use the Twitter platform? Twitter offers a platform with a number of different ways to interact with it. Web Intents, Tweet Button and Follow Button is the simplest way to bring basic Twitter functionality to your site. It provides features like the ability to tweet, retweet, or follow using basic HTML and Javascript. You...
I keep hitting the rate limit. How do I get more requests per hour? REST & Search API Whitelisting is not provided. Resourceful use of more efficient REST API requests, authentication, and Streaming APIs will allow you to build your integration successfully without requiring whitelisting. Learn more about rate limits or see the rate limiting FAQ for more...
Tweet Entities See also Entities from the Field Guide. Why Tweet Entities? Tweet text can potentially mention other users or lists, but also contain URLs, media, hashtags... Instead of parsing the text yourself to try to extract those entities, you can use the entities attribute that contains this parsed...
May 17, 2012
Document Description
What kind of data does the Twitter Platform capture? Like many companies, Twitter receives log data from visits to websites that use our social widgets, such as our Tweet and Follow buttons. This log data may include information such as IP address, browser type, the referring web page, pages visited, cookies, and other interactions with the buttons...
API Terms of Service: Archive Previous API Terms of Service (NOT CURRENT) Please Note: These terms are NOT current. Please read the current terms. Most recent changes June 1, 2011 April 13, 2011
API Terms of Service: Most recent changes Please Note: These terms are NOT current. Please read the current terms. Last Update: June 1, 2011 May 17, 2012. Return to the API Terms of Service: Archive. Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and...
API Terms of Service: June 1, 2011 Please Note: These terms are NOT current. Please read the current terms. Last Update: June 1, 2011. Return to the API Terms of Service: Archive. Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and discovering...
API Terms of Service: April 13, 2011 Please Note: These terms are NOT current. Please read the current terms. Last Update: April 13, 2011. Return to the API Terms of Service: Archive. Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and...
Public streams Overview Endpoints Using the streaming APIs Connections Overview The following streams offer samples of the public data flowing through Twitter. Once applications establish a connection to a streaming endpoint, they a delivered a feed of Tweets, without needing to worry about...
POST direct_messages/new Sends a new direct message to the specified user from the authenticating user. Requires both the user and text parameters and must be a POST. Returns the sent message in the requested format if successful.
May 15, 2012
Document Description
Processing streaming data Parsing responses JSON data Transfer-Encoding: chunked Delimited messages Falling behind Scaling Message ordering Duplicate messages Gzip compression Gzip and EventMachine Gzip and Java Parsing responses The body of a streaming API response consists of a series of newline-...