Recently Updated Documentation

September 15, 2011
Document Description
xAuth About xAuth xAuth is still OAuth. You still need to master how to send signed requests to Twitter. The xAuth process will only yield read-only or read-write access tokens. Direct message read access is not provided with xAuth. If your application requires access to a user's direct messages,...
September 7, 2011
Document Description
Adding international support to your apps If your audience speaks a language other than English, we recommend you use a localized UI. To help you do this, we've created glossary pages on our translation center: Dutch Filipino French German Hindi Indonesian Italian Korean Malay Portuguese Russian Simplified...
August 31, 2011
Document Description
t.co Link Wrapper FAQ When are links wrapped with t.co? Do I need to make an extra API call? Will t.co-wrapped links always be the same length? How do I calculate if a Tweet with a link is going to be over 140 characters or not? My application or users already use URL shorteners. Will this break URL shortening...
Working with t.co: Best Practices Linking to content within tweets We recommend the following when rendering links within Tweets: Use the "url" value of a URL entity for the href attribute of an anchor tag. Use the "expanded_url" value of a URL entity for the title attribute of an anchor tag, so that when users hover over the...
t.co Redirection Behavior t.co currently handles redirections by context and known user agents. We've taken care to preserve original referrers in all contexts where they are reliably provided. Source of click Referrer non-twitter.com domainswith specified referrer original...
User Streams Suggestions Overview Adding User Stream support to a REST-based Twitter client requires handling a few additional issues. This summary should help developers estimate the scope of work and possibly avoid a few pitfalls. Refer to the Streaming API documentation for more details on the Twitter Streaming API...
User Streams Overview User Streams provides real-time updates of all data needed to update a desktop application display. Applications can request startup back-fill from the REST API and then transition to Streaming for nearly all subsequent reads. Rate limits and latency are practically eliminated. Desktop...
August 30, 2011
Document Description
Useful Articles Written By Others On OAuth Apigee's OAuth: the Big Picture Using OAuth for Twitter Authentication on the BlackBerry PlayBook Using Twitter API with LIFT, Scala, and Twitter4J How Klout is Harnessing the Twitter Firehose to Keep Pace with Their Growing User Base On Rendering Tweets Create a Twitter Feed...
August 18, 2011
Document Description
Twitter Libraries A list of Twitter & OAuth libraries. Feel free to send us a tweet @twitterapi if you think we're missing a good one. Note there's also an index of OAuth libraries provided by the OAuth site. ActionScript/Flash C++ Clojure Erlang Java JavaScript .NET Objective-C / Cocoa Perl...
August 17, 2011
Document Description
POST statuses/update_with_media Updates the authenticating user's status and attaches media for upload. Unlike POST statuses/update, this method expects raw multipart data. Your POST request's Content-Type should be set to multipart/form-data with the media[] parameter The Tweet text will be rewritten to include the media...
August 9, 2011
Document Description
Rate Limiting FAQ Where can I find information about what rate limiting is? Are rate limits per user, per computer or per application? Why did Twitter choose the World Cup 2010 as a time to start dynamically rating the API I have a whitelisted account and cannot operate with a really small rate limit Will...
July 18, 2011
Document Description
POST oauth/access_token Allows a Consumer application to exchange the OAuth Request Token for an OAuth Access Token. This method fulfills Section 6.3 of the OAuth 1.0 authentication flow. The OAuth access token may also be used for xAuth operations. Please use HTTPS for this method, and all other OAuth token negotiation...
July 15, 2011
Document Description
Rate Limiting REST API Rate Limiting Feature-based rate limiting Knowing if you are rate limited Whitelisting Search API Rate Limiting Tips to avoid being Rate Limited Blacklisting Streaming API Questions? The Twitter API only allows clients to make a limited number of calls in a given hour....
July 14, 2011
Document Description
POST account/update_profile_image Updates the authenticating user's profile image. Note that this method expects raw multipart data, not a URL to an image. This method asynchronously processes the uploaded file before updating the user's profile image URL. You can either update your local cache the next time you request the user's...
July 13, 2011
Document Description
Moving from Basic Auth to OAuth Transitioning from Basic Authentication to OAuth isn't simple for everyone. You're going from an approach where you send a login and password with every REST API request you make to one in which you're first having to acquire user authorization, and then sending credentials that both identify your...
July 12, 2011
Document Description
The Application Permission Model Table of Contents A few updates about the permission model change The new permission level announcement email Questions and Answers A few updates about the permission model change Sent Jun 13, 2011 Hey everyone, A number of updates were made to the Direct Message...
July 11, 2011
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. 200 OK: Success! 304 Not Modified: There was no new data to return. 400 Bad Request: The request was invalid. An...
Developers For Hire The following developers have expressed interest in independent work developing applications for the Twitter API. Please contact them directly to inquire for their ability in helping develop a Twitter application for your needs. Note that these developers are community members and are not...
GET statuses/friends_timeline This method is deprecated and has been replaced by GET statuses/home_timeline. Please update your applications with the new endpoint. Returns the 20 most recent statuses posted by the authenticating user and the user's they follow. This is the same timeline seen by a user when they login to twitter...
API FAQ Basics What's an API? How do I use the Twitter API? How do I count out 140 characters? What is the version of the REST API? I Need Something! How do I get “via [MyApp]” appended to updates sent from my API application? I keep hitting the rate limit. How do I get more...