Recently Updated Documentation

April 23, 2013
Document Description
GET geo/reverse_geocode Given a latitude and a longitude, searches for up to 20 places that can be used as a place_id when updating a status. This request is an informative call and will deliver generalized results about geography.
GET lists/list Returns all lists the authenticating or specified user subscribes to, including their own. The user is specified using the user_id or screen_name parameters. If no user is given, the authenticating user is used. This method used to be GET lists in version 1.0 of the API and has been renamed for...
GET users/suggestions/:slug/members Access the users in a given category of the Twitter suggested user list and return their most recent status if they are not a protected user.
GET users/suggestions Access to Twitter's suggested user list. This returns the list of suggested user categories. The category can be used in GET users/suggestions/:slug to get the users in that category.
GET users/suggestions/:slug Access the users in a given category of the Twitter suggested user list. It is recommended that applications cache this data for no more than one hour.
GET users/show Returns a variety of information about the user specified by the required user_id or screen_name parameter. The author's most recent Tweet will be returned inline when possible. GET users/lookup is used to retrieve a bulk collection of user objects.
GET friendships/show Returns detailed information about the relationship between two arbitrary users.
POST friendships/update Allows one to enable or disable retweets and device notifications from the specified user.
GET friendships/outgoing Returns a collection of numeric IDs for every protected user for whom the authenticating user has a pending follow request.
GET friendships/lookup Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names or user_ids provided. Values for connections can be: following, following_requested, followed_by, none.
April 18, 2013
Document Description
Web Intents By using Web Intents, you agree to the Developer Rules of the Road. Make it easy to bring interactivity to Tweets that you display on the web. Web Intents provide popup-optimized flows for working with Tweets & Twitter Users: Tweet, Reply, Retweet, Favorite, and Follow. They make it possible...
Tweet Button By using the Tweet Button, you agree to the Developer Rules of the Road. Overview The Tweet Button is a small widget which allows users to easily share your website with their followers. This page is for developers and users who wish to build their own Tweet Buttons. If you are looking for a...
April 15, 2013
Document Description
How do I count favorites? The number of times a tweet was favorited is now available as part of tweet objects in the REST, Streaming, and Search APIs -- you'll find it presented in the "favorite_count" field. Additionally, User streams and Site streams both stream events when an authenticated user favorites tweets or has...
April 12, 2013
Document Description
GET oauth/authenticate Allows a Consumer application to use an OAuth request_token to request user authorization. This method is a replacement of Section 6.2 of the OAuth 1.0 authentication flow for applications using the callback authentication flow. The method will use the currently logged in user as the account for...
April 11, 2013
Document Description
GET lists/ownerships Returns the lists owned by the specified Twitter user. Private lists will only be shown if the authenticated user is also the owner of the lists.
April 4, 2013
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...
April 3, 2013
Document Description
How do I use the REST API over JSON-P? The REST API supports a callback parameter on nearly all methods. See Things Every Developer Should Know for more information. In API v1.1 all requests require authentication. Because of this, most JSON-P use cases are actively discouraged as it is rarely possible to perform without exposing your...
How do I obtain an API key? You can create an application record (which includes an API key) by navigating to Application Management. Most integrations with the API will require you to identify your application to Twitter by way of an API key. On the Twitter platform, the term "API key" usually refers to what's called an...
How do I count out 140 characters? While Tweets are still limited to 140 characters, the character counting model has evolved over time. Tweets are UTF-8 string content and any UTF-8 character counts as a single character. Strings that are understood as links, such as "http://twitter.com", "twitter.com", "twitter.com/twitterapi"...
How can I keep up with changes to the Twitter API? There are a few great ways to follow the changes we make to the Twitter platform: Follow @twitterapi. Keep track of our Developer Blog and Discussions. See the recently updated documentation. Consult the Platform Calendar.