Recently Updated Documentation

March 12, 2012
Document Description
How do I get "via [MyApp]" appended to updates sent from my API application? The source attribution of a Tweet is set by the name of the application used to create it. If you register an application we will use it's name and URL as the source for any Tweet it creates. Application names must be unique so if the application name you wish to use is taken, please choose...
What's an API? The acronym "API" stands for "Application Programming Interface". An API is a defined way for a program to accomplish a task, usually by retrieving or modifying data. In Twitter's case, we provide an API method for just about every feature you can see on our website. Programmers use the Twitter...
March 8, 2012
Document Description
GET trends/:woeid Returns the top 10 trending topics for a specific WOEID, if trending information is available for it. The response is an array of "trend" objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Twitter Search, and the Twitter Search URL....
March 6, 2012
Document Description
GET statuses/public_timeline Returns the 20 most recent statuses, including retweets if they exist, from non-protected users. The public timeline is cached for 60 seconds. Requesting more frequently than that will not return any more data, and will count against your rate limit usage. Use the Streaming API's sample...
Authorizing a request Overview The purpose of this document is to show you how to modify HTTP requests for the purpose of sending authorized requests to the Twitter API. All of Twitter's APIs are based on the HTTP protocol. This means that any software you write which uses Twitter's APIs sends a series of...
February 28, 2012
Document Description
OAuth Echo OAuth Echo is a means to securely delegate OAuth authorization with a third party while interacting with an API. Within the Twitter ecosystem, we use OAuth Echo as a means to allow your application to use services such as Twitpic and yfrog. OAuth Echo is still OAuth. OAuth Echo does not require...
February 27, 2012
Document Description
Frequently Asked Questions Frequent Asked Questions I'm receiving authentication errors when using TWRequest. What's going on? Do TWRequest and TWTweetComposeViewController calls automatically wrap urls in statuses updates? Why is my application attributed as "from iOS" instead of "from <my application>" on...
February 23, 2012
Document Description
Implementing Sign in with Twitter Overview The browser and mobile web implementations of Sign in with Twitter are based off of OAuth. This page demonstrates the requests needed to obtain an access token for the sign in flow. For information on implementing Sign in with Twitter for iOS, see iOS Twitter framework. This page...
February 13, 2012
Document Description
Authentication & Authorization Twitter supports a few authentication methods and with a range of OAuth authentication styles you may be wondering which method you should be using. When choosing which authentication method to use you should understand the way that method will affect your users experience and the way you write...
Using OAuth Introduction Understanding the way OAuth works can help create and debug applications which use Twitter's API. To use OAuth, an application must: Obtain access tokens to act on behalf of a user account. Authorize all HTTP requests it sends to Twitter's APIs. The following...
February 3, 2012
Document Description
OAuth Send secure authorized requests to the Twitter API Twitter uses OAuth to provide authorized access to its API. Features Secure - Users are not required to share their passwords with 3rd party applications, increasing account security. Standard - A wealth of client libraries and...
February 2, 2012
Document Description
@NVVoteCount Tweet Format Specification Use this information to interpret the tweets issued by @NVVoteCount. See Stream the Nevada Caucus Results with the Twitter API for more information. Tweet Type Indicator All Tweets will begin with a single-character indicator of Tweet Type: X: Tweet contains general information, intended...
February 1, 2012
Document Description
Posting images using TWRequest Overview The Twitter framework's TWRequest encapsulates calls to the Twitter API, including signing the request on behalf of the user. With Twitter's photo hosting service, and its API endpoint POST statuses/update_with_media, it is possible to post a Tweet and a status simultaneously via a...
January 20, 2012
Document Description
POST friendships/update Allows one to enable or disable retweets and device notifications from the specified user.
January 4, 2012
Document Description
Exploring the Twitter API Explore the API on your own machine using Twitter for Mac's developer console or our command-line Twurl tool. Explore the API here by using this console provided by @apigee. Your browser does not support iframes.
Tweet Button FAQ Which browsers does the Tweet Button support? Does the Tweet Button support other languages? What are the dimensions of the Tweet Button and Share Box? What happens if twitter.com has an error or is over capacity? I want to use multiple Tweet Buttons on my page. Is there anything I should...
@Anywhere Features: Tweet Box Overview The Tweet Box allows Twitter users to tweet directly from within your web site or web application. Basic Usage The default Tweet Box will work without any customizations and is activated using this short snippet. This code will display a Tweet Box on the page inside the div with...
December 15, 2011
Document Description
GET help/configuration Returns the current configuration used by Twitter including twitter.com slugs which are not usernames, maximum photo resolutions, and t.co URL lengths. It is recommended applications request this endpoint when they are loaded, but no more than once a day.
December 14, 2011
Document Description
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...
December 8, 2011
Document Description
Web Intents Javascript Events By using Web Intents Javascript Events, you agree to the Developer Rules of the Road. If you're integrating your site with Twitter using Web Intents, the Tweet Button and the Follow Button, and you want to detect the value you're getting from the integration, Web Intents Events provide the easiest...