REST API Resources | Twitter Developers

<!DOCTYPE html><head><script type="text/javascript" src="https://web-static.archive.org/_static/js/bundle-playback.js?v=7YQSqjSh" charset="utf-8"></script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://dev.twitter.com/docs/api","20111109103742","https://web.archive.org/","web","https://web-static.archive.org/_static/", "1320835062"); </script> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/banner-styles.css?v=p7PEIJWi" /> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/iconochive.css?v=3PDvdIFv" />  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>REST API Resources | Twitter Developers</title> <script src="https://web.archive.org/web/20111109103742js_/https://platform.twitter.com/widgets.js" type="text/javascript"></script> <link rel="shortcut icon" href="/web/20111109103742im_/https://dev.twitter.com/sites/all/themes/twitter_commons/favicon.ico" type="image/x-icon"/> <link type="text/css" rel="stylesheet" media="all" href="/web/20111109103742cs_/https://dev.twitter.com/sites/default/files/css/css_258ec3672782fadbaf9030ffbcabd5e3.css"/> <script type="text/javascript" src="/web/20111109103742js_/https://dev.twitter.com/sites/default/files/js/js_6a0ca864189781d957cde9705a092b22.js"></script> <script type="text/javascript"> <![CDATA[//><!]]> </script> </head> <body id="page-docs" class="not-front not-logged-in no-sidebars"> <div id="page"> <a href="#content-main" class="skip">Skip to Main Content Area</a> <div id="header-outer"> <div id="header"> <a href="/web/20111109103742/https://dev.twitter.com/" id="logo" title="Home"> Developers </a> <form action="/web/20111109103742/https://dev.twitter.com/docs/api" accept-charset="UTF-8" method="post" id="search-theme-form"> <input id="search-q" name="search_theme_form" type="text" maxlength="128" size="15" value="Search" title="Enter search terms" placeholder="Search"/> <input id="search-submit" name="op" type="submit" value="Search"/> <input type="hidden" name="form_build_id" id="form-e9897a4aafa8d152a3486e9226cb9eec" value="form-e9897a4aafa8d152a3486e9226cb9eec"/> <input type="hidden" name="form_id" id="edit-search-theme-form" value="search_theme_form"/> </form> <ul id="title-nav"><li class="expanded first"><a href="/web/20111109103742/https://dev.twitter.com/status" title="">API Health</a><ul class="menu"><li class="leaf first"><a href="/web/20111109103742/https://dev.twitter.com/status" title="">API Status</a></li> <li class="leaf last"><a href="/web/20111109103742/https://dev.twitter.com/issues" title="">API Issues</a></li> </ul></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/blog" title="">Blog</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/discussions" title="">Discussions</a></li> <li class="expanded active-trail"><a href="/web/20111109103742/https://dev.twitter.com/docs" title="">Documentation</a><ul class="menu"><li class="leaf first"><a href="/web/20111109103742/https://dev.twitter.com/docs" title="">Overview</a></li> <li class="leaf active-trail"><a href="/web/20111109103742/https://dev.twitter.com/docs/api" title="" class="active">REST API</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/docs/streaming-api" title="Streaming API">Streaming API</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/docs/twitter-for-websites" title="">Twitter for Websites</a></li> <li class="leaf last"><a href="/web/20111109103742/https://dev.twitter.com/docs/recent" title="">Recently updated</a></li> </ul></li> <li class="leaf last"><a href="/web/20111109103742/https://dev.twitter.com/user/login?destination=docs%2Fapi" title="">Sign in</a></li> </ul> </div> </div> <div id="content-outer"> <div id="breadcrumbs"> <div class="breadcrumb"><a href="/web/20111109103742/https://dev.twitter.com/">Home</a> → <a href="/web/20111109103742/https://dev.twitter.com/docs">Documentation</a><div></div></div> </div> <div id="preface"> <div id="dropdown"> <ul> <li><span class="title">Jump to</span> <ul class="menu"> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#accounts">Accounts</a> (10)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#block">Block</a> (5)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#deprecated">Deprecated</a> (25)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#direct-messages">Direct Messages</a> (5)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#favorites">Favorites</a> (3)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#friends-followers">Friends & Followers</a> (11)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#help">Help</a> (3)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#legal">Legal</a> (2)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#lists">Lists</a> (18)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#local-trends">Local Trends</a> (2)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#notification">Notification</a> (3)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#oauth">OAuth</a> (4)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#places-geo">Places & Geo</a> (5)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#saved-searches">Saved Searches</a> (4)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#search">Search</a> (2)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#spam-reporting">Spam Reporting</a> (1)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#streaming">Streaming</a> (1)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#suggested-users">Suggested Users</a> (3)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#timelines">Timelines</a> (11)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#trends">Trends</a> (2)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#tweets">Tweets</a> (9)</li> <li> <a href="/web/20111109103742/https://dev.twitter.com/docs/api#users">Users</a> (6)</li> </ul> </li> </ul> </div> </div> <h1 id="title">REST API Resources</h1> <div id="content-inner"> <div id="content-main"> <div class="view api-docs"> <div class="content"> <table class="views-table cols-9"> <caption><a id="timelines"></a><strong>Timelines</strong><p> Timelines are collections of Tweets, ordered with the most recent first. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd views-row-first"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/home_timeline">GET statuses/home_timeline</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent statuses, including retweets if they exist, 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.com. This method is identical to statuses/friends_timeline, except that this method always... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/mentions">GET statuses/mentions</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent mentions (status containing @username) for the authenticating user. The timeline returned is the equivalent of the one seen when you view your mentions on twitter.com. This method can only return up to 800 statuses. If include_rts is set only 800 statuses, including... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/public_timeline">GET statuses/public_timeline</a> </td> <td class="views-field views-field-body"> 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. Consider using the Streaming API's... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/retweeted_by_me">GET statuses/retweeted_by_me</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent retweets posted by the authenticating user. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/retweeted_to_me">GET statuses/retweeted_to_me</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent retweets posted by users the authenticating user follow. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/retweets_of_me">GET statuses/retweets_of_me</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent tweets of the authenticated user that have been retweeted by others. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/user_timeline">GET statuses/user_timeline</a> </td> <td class="views-field views-field-body"> 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... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/retweeted_to_user">GET statuses/retweeted_to_user</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent retweets posted by users the specified user follows. The user is specified using the user_id or screen_name parameters. This method is identical to statuses/retweeted_to_me except you can choose the user to view. </td> </tr> <tr class="odd views-row-last"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/retweeted_by_user">GET statuses/retweeted_by_user</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent retweets posted by the specified user. The user is specified using the user_id or screen_name parameters. This method is identical to statuses/retweeted_by_me except you can choose the user to view. Does not require authentication, unless the user is protected. </td> </tr> </tbody> </table> <table class="views-table cols-8"> <caption><a id="tweets"></a><strong>Tweets</strong><p> Tweets are the atomic building blocks of Twitter, 140-character status updates with additional associated metadata. People tweet for a variety of reasons about a multitude of topics. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/%3Aid/retweeted_by">GET statuses/:id/retweeted_by</a> </td> <td class="views-field views-field-body"> Show user objects of up to 100 members who retweeted the status. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/%3Aid/retweeted_by/ids">GET statuses/:id/retweeted_by/ids</a> </td> <td class="views-field views-field-body"> Show user ids of up to 100 users who retweeted the status. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/retweets/%3Aid">GET statuses/retweets/:id</a> </td> <td class="views-field views-field-body"> Returns up to 100 of the first retweets of a given tweet. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/show/%3Aid">GET statuses/show/:id</a> </td> <td class="views-field views-field-body"> Returns a single status, specified by the id parameter below. The status's author will be returned inline. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/statuses/destroy/%3Aid">POST statuses/destroy/:id</a> </td> <td class="views-field views-field-body"> Destroys the status specified by the required ID parameter. The authenticating user must be the author of the specified status. Returns the destroyed status if successful. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/statuses/retweet/%3Aid">POST statuses/retweet/:id</a> </td> <td class="views-field views-field-body"> Retweets a tweet. Returns the original tweet with retweet details embedded. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/statuses/update">POST statuses/update</a> </td> <td class="views-field views-field-body"> Updates the authenticating user's 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 will be... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/statuses/update_with_media">POST statuses/update_with_media</a> </td> <td class="views-field views-field-body"> 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... </td> </tr> </tbody> </table> <table class="views-table cols-1"> <caption><a id="search"></a><strong>Search</strong><p> Find relevant Tweets based on queries performed by your users. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/search">GET search</a> </td> <td class="views-field views-field-body"> Returns tweets that match a specified query. To best learn how to use Twitter Search effectively, consult our guide to Using the Twitter Search API Notice: As of April 1st 2010, the Search API provides an option to retrieve "popular tweets" in addition to real-time search results. In an upcoming... </td> </tr> </tbody> </table> <table class="views-table cols-5"> <caption><a id="direct-messages"></a><strong>Direct Messages</strong><p> Direct Messages are short, non-public messages sent between two users. Access to Direct Messages is governed by the <a href="https://web.archive.org/web/20111109103742/https://dev.twitter.com/docs/application-permission-model">The Application Permission Model</a>. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/direct_messages">GET direct_messages</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent direct messages sent to the authenticating user. The XML and JSON versions include detailed information about the sender and recipient user. Important: This method requires an access token with RWD (read, write... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/direct_messages/sent">GET direct_messages/sent</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent direct messages sent by the authenticating user. The XML and JSON versions include detailed information about the sender and recipient user. Important: This method requires an access token with RWD (read, write... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/direct_messages/destroy/%3Aid">POST direct_messages/destroy/:id</a> </td> <td class="views-field views-field-body"> Important: This method requires an access token with RWD (read, write... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/direct_messages/new">POST direct_messages/new</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/direct_messages/show/%3Aid">GET direct_messages/show/:id</a> </td> <td class="views-field views-field-body"> Returns a single direct message, specified by an id parameter. Like the /1/direct_messages.format request, this method will include the user objects of the sender and recipient. Important: This method requires an access token with RWD (read, write... </td> </tr> </tbody> </table> <table class="views-table cols-11"> <caption><a id="friends-followers"></a><strong>Friends & Followers</strong><p> Users follow their interests on Twitter through both one-way and mutual following relationships. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/followers/ids">GET followers/ids</a> </td> <td class="views-field views-field-body"> Returns an array of numeric IDs for every user following the specified user. This method is powerful when used in conjunction with users/lookup. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friends/ids">GET friends/ids</a> </td> <td class="views-field views-field-body"> Returns an array of numeric IDs for every user the specified user is following. This method is powerful when used in conjunction with users/lookup. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friendships/exists">GET friendships/exists</a> </td> <td class="views-field views-field-body"> Test for the existence of friendship between two users. Will return true if user_a follows user_b, otherwise will return false. Authentication is required if either user A or user B are protected. Additionally the authenticating user must be a follower of the protected user. Consider using... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friendships/incoming">GET friendships/incoming</a> </td> <td class="views-field views-field-body"> Returns an array of numeric IDs for every user who has a pending request to follow the authenticating user. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friendships/outgoing">GET friendships/outgoing</a> </td> <td class="views-field views-field-body"> Returns an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friendships/show">GET friendships/show</a> </td> <td class="views-field views-field-body"> Returns detailed information about the relationship between two users. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/friendships/create">POST friendships/create</a> </td> <td class="views-field views-field-body"> Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. If you are already friends with the user a HTTP 403 may be returned, though for... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/friendships/destroy">POST friendships/destroy</a> </td> <td class="views-field views-field-body"> Allows the authenticating users to unfollow the user specified in the ID parameter. Returns the unfollowed user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friendships/lookup">GET friendships/lookup</a> </td> <td class="views-field views-field-body"> Returns the relationship 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. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/friendships/update">POST friendships/update</a> </td> <td class="views-field views-field-body"> Allows one to enable or disable retweets and device notifications from the specified user. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/friendships/no_retweet_ids">GET friendships/no_retweet_ids</a> </td> <td class="views-field views-field-body"> Returns an array of user_ids that the currently authenticated user does not want to see retweets from. </td> </tr> </tbody> </table> <table class="views-table cols-6"> <caption><a id="users"></a><strong>Users</strong><p> Users are at the center of everything Twitter: they follow, they favorite, and tweet & retweet. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/lookup">GET users/lookup</a> </td> <td class="views-field views-field-body"> Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two. The author's most recent status (if the authenticating user has permission) will be returned inline. This method is crucial for consumers of the Streaming API. It's also well suited... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/profile_image/%3Ascreen_name">GET users/profile_image/:screen_name</a> </td> <td class="views-field views-field-body"> Access the profile image in various sizes for the user with the indicated screen_name. If no size is provided the normal image is returned. This resource does not return JSON or XML, but instead returns a 302 redirect to the actual image resource. This method should only be used by application... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/search">GET users/search</a> </td> <td class="views-field views-field-body"> Runs a search for users similar to Find People button on Twitter.com. The results returned by people search on Twitter.com are the same as those returned by this API request. Note that unlike GET search, this method does not support any operators. Only the first 1000 matches are available. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/show">GET users/show</a> </td> <td class="views-field views-field-body"> Returns extended information of a given user, specified by ID or screen name as per the required id parameter. The author's most recent status will be returned inline. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/contributees">GET users/contributees</a> </td> <td class="views-field views-field-body"> Returns an array of users that the specified user can contribute to. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/contributors">GET users/contributors</a> </td> <td class="views-field views-field-body"> Returns an array of users who can contribute to the specified account. </td> </tr> </tbody> </table> <table class="views-table cols-3"> <caption><a id="suggested-users"></a><strong>Suggested Users</strong><p> Categorical organization of users that others may be interested to follow. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/suggestions">GET users/suggestions</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/suggestions/%3Aslug">GET users/suggestions/:slug</a> </td> <td class="views-field views-field-body"> Access the users in a given category of the Twitter suggested user list. It is recommended that end clients cache this data for no more than one hour. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/users/suggestions/%3Aslug/members">GET users/suggestions/:slug/members.format</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> </tbody> </table> <table class="views-table cols-3"> <caption><a id="favorites"></a><strong>Favorites</strong><p> Users favorite tweets to give recognition to awesome tweets, to curate the best of Twitter, to save for reading later, and a variety of other reasons. Likewise, developers make use of "favs" in many different ways. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/favorites">GET favorites</a> </td> <td class="views-field views-field-body"> Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/favorites/create/%3Aid">POST favorites/create/:id</a> </td> <td class="views-field views-field-body"> Favorites the status specified in the ID parameter as the authenticating user. Returns the favorite status when successful. This process invoked by this method is asynchronous. The immediately returned status may not indicate the resultant favorited status of the tweet. A 200 OK response from this... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/favorites/destroy/%3Aid">POST favorites/destroy/:id</a> </td> <td class="views-field views-field-body"> Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited status in the requested format when successful. This process invoked by this method is asynchronous. The immediately returned status may not indicate the resultant favorited status of the... </td> </tr> </tbody> </table> <table class="views-table cols-18"> <caption><a id="lists"></a><strong>Lists</strong><p> Lists are collections of tweets, culled from a curated list of Twitter users. List timeline methods include tweets by all members of a list. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/all">GET lists/all</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/statuses">GET lists/statuses</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/members/destroy">POST lists/members/destroy</a> </td> <td class="views-field views-field-body"> Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/memberships">GET lists/memberships</a> </td> <td class="views-field views-field-body"> Returns the lists the specified user has been added to. If user_id or screen_name are not provided the memberships for the authenticating user are returned. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/subscribers">GET lists/subscribers</a> </td> <td class="views-field views-field-body"> Returns the subscribers of the specified list. Private list subscribers will only be shown if the authenticated user owns the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/subscribers/create">POST lists/subscribers/create</a> </td> <td class="views-field views-field-body"> Subscribes the authenticated user to the specified list. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/subscribers/show">GET lists/subscribers/show</a> </td> <td class="views-field views-field-body"> Check if the specified user is a subscriber of the specified list. Returns the user if they are subscriber. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/subscribers/destroy">POST lists/subscribers/destroy</a> </td> <td class="views-field views-field-body"> Unsubscribes the authenticated user from the specified list. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/members/create_all">POST lists/members/create_all</a> </td> <td class="views-field views-field-body"> Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 500 members, and you are limited to adding up to 100 members to a list at a time with... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/members/show">GET lists/members/show</a> </td> <td class="views-field views-field-body"> Check if the specified user is a member of the specified list. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/members">GET lists/members</a> </td> <td class="views-field views-field-body"> Returns the members of the specified list. Private list members will only be shown if the authenticated user owns the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/members/create">POST lists/members/create</a> </td> <td class="views-field views-field-body"> Add a member to a list. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 500 members. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/destroy">POST lists/destroy</a> </td> <td class="views-field views-field-body"> Deletes the specified list. The authenticated user must own the list to be able to destroy it. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/update">POST lists/update</a> </td> <td class="views-field views-field-body"> Updates the specified list. The authenticated user must own the list to be able to update it. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/lists/create">POST lists/create</a> </td> <td class="views-field views-field-body"> Creates a new list for the authenticated user. Note that you can't create more than 20 lists per account. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists">GET lists</a> </td> <td class="views-field views-field-body"> Returns the lists of the specified (or authenticated) user. Private lists will be included if the authenticated user is the same as the user whose lists are being returned. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/show">GET lists/show</a> </td> <td class="views-field views-field-body"> Returns the specified list. Private lists will only be shown if the authenticated user owns the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/lists/subscriptions">GET lists/subscriptions</a> </td> <td class="views-field views-field-body"> Obtain a collection of the lists the specified user is subscribed to, 20 lists per page by default. </td> </tr> </tbody> </table> <table class="views-table cols-10"> <caption><a id="accounts"></a><strong>Accounts</strong><p> Account-level configuration settings for users. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/account/rate_limit_status">GET account/rate_limit_status</a> </td> <td class="views-field views-field-body"> Returns the remaining number of API requests available to the requesting user before the API limit is reached for the current hour. Calls to rate_limit_status do not count against the rate limit. If authentication credentials are provided, the rate limit status for the authenticating user is... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/account/verify_credentials">GET account/verify_credentials</a> </td> <td class="views-field views-field-body"> Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not. Use this method to test if supplied user credentials are valid. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/end_session">POST account/end_session</a> </td> <td class="views-field views-field-body"> Ends the session of the authenticating user, returning a null cookie. Use this method to sign users out of client-facing applications like widgets. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/update_profile">POST account/update_profile</a> </td> <td class="views-field views-field-body"> Sets values that users are able to set under the "Account" tab of their settings page. Only the parameters specified will be updated. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/update_profile_background_image">POST account/update_profile_background_image</a> </td> <td class="views-field views-field-body"> Updates the authenticating user's profile background image. This method can also be used to enable or disable the profile background image. Although each parameter is marked as optional, at least one of image, tile or use must be provided when making this request. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/update_profile_colors">POST account/update_profile_colors</a> </td> <td class="views-field views-field-body"> Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.com. Each parameter's value must be a valid hexidecimal value, and may be either three or six characters (ex: #fff or #ffffff). </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/update_profile_image">POST account/update_profile_image</a> </td> <td class="views-field views-field-body"> 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... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/account/totals">GET account/totals</a> </td> <td class="views-field views-field-body"> Returns the current count of friends, followers, updates (statuses) and favorites of the authenticating user. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/account/settings">GET account/settings</a> </td> <td class="views-field views-field-body"> Returns settings (including current trend, geo and sleep time information) for the authenticating user. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/settings">POST account/settings</a> </td> <td class="views-field views-field-body"> Updates the authenticating user's settings. </td> </tr> </tbody> </table> <table class="views-table cols-2"> <caption><a id="notification"></a><strong>Notification</strong><p> Controls SMS-based notifications that a user wants to receive. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/notifications/follow">POST notifications/follow</a> </td> <td class="views-field views-field-body"> Enables device notifications for updates from the specified user. Returns the specified user when successful. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/notifications/leave">POST notifications/leave</a> </td> <td class="views-field views-field-body"> Disables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful. </td> </tr> </tbody> </table> <table class="views-table cols-4"> <caption><a id="saved-searches"></a><strong>Saved Searches</strong><p> Allows users to save references to search criteria for reuse later. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/saved_searches">GET saved_searches</a> </td> <td class="views-field views-field-body"> Returns the authenticated user's saved search queries. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/saved_searches/show/%3Aid">GET saved_searches/show/:id</a> </td> <td class="views-field views-field-body"> Retrieve the information for the saved search represented by the given id. The authenticating user must be the owner of saved search ID being requested. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/saved_searches/create">POST saved_searches/create</a> </td> <td class="views-field views-field-body"> Create a new saved search for the authenticated user. A user may only have 25 saved searches. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/saved_searches/destroy/%3Aid">POST saved_searches/destroy/:id</a> </td> <td class="views-field views-field-body"> Destroys a saved search for the authenticating user. The authenticating user must be the owner of saved search id being destroyed. </td> </tr> </tbody> </table> <table class="views-table cols-2"> <caption><a id="local-trends"></a><strong>Local Trends</strong><p> Trending content specific to certain geographic areas. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/trends/%3Awoeid">GET trends/:woeid</a> </td> <td class="views-field views-field-body"> 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.... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/trends/available">GET trends/available</a> </td> <td class="views-field views-field-body"> Returns the locations that Twitter has trending topic information for. The response is an array of "locations" that encode the location's WOEID and some other human-readable information such as a canonical name and country the location belongs in. A WOEID is a Yahoo! Where On Earth ID. </td> </tr> </tbody> </table> <table class="views-table cols-5"> <caption><a id="places-geo"></a><strong>Places & Geo</strong><p> Users tweet from all over the world. These methods allow you to attach location data to tweets and discover tweets & locations. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/geo/id/%3Aplace_id">GET geo/id/:place_id</a> </td> <td class="views-field views-field-body"> Returns all the information about a known place. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/geo/reverse_geocode">GET geo/reverse_geocode</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/geo/search">GET geo/search</a> </td> <td class="views-field views-field-body"> Search for places that can be attached to a statuses/update. Given a latitude and a longitude pair, an IP address, or a name, this request will return a list of all the valid places that can be used as the place_id when updating a status. Conceptually, a query can be made from the user's location... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/geo/similar_places">GET geo/similar_places</a> </td> <td class="views-field views-field-body"> Locates places near the given coordinates which are similar in name. Conceptually you would use this method to get a list of known places to choose from first. Then, if the desired place doesn't exist, make a request to post/geo/place to create a new one. The token contained in the response is the... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/geo/place">POST geo/place</a> </td> <td class="views-field views-field-body"> Creates a new place object at the given latitude and longitude. Before creating a place you need to query GET geo/similar_places with the latitude, longitude and name of the place you wish to create. The query will return an array of places which are similar to the one you wish to create, and a... </td> </tr> </tbody> </table> <table class="views-table cols-2"> <caption><a id="trends"></a><strong>Trends</strong><p> With so many tweets from so many users, themes are bound to arise from the zeitgeist. The Trends methods allow you to explore what's trending on Twitter. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/trends/daily">GET trends/daily</a> </td> <td class="views-field views-field-body"> Returns the top 20 trending topics for each hour in a given day. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/trends/weekly">GET trends/weekly</a> </td> <td class="views-field views-field-body"> Returns the top 30 trending topics for each day in a given week. </td> </tr> </tbody> </table> <table class="views-table cols-5"> <caption><a id="block"></a><strong>Block</strong><p> Allows users to block and unblock other users. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/blocks/blocking">GET blocks/blocking</a> </td> <td class="views-field views-field-body"> Returns an array of user objects that the authenticating user is blocking. Consider using GET blocks/blocking/ids with GET users/lookup instead of this method. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/blocks/blocking/ids">GET blocks/blocking/ids</a> </td> <td class="views-field views-field-body"> Returns an array of numeric user ids the authenticating user is blocking. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/blocks/exists">GET blocks/exists</a> </td> <td class="views-field views-field-body"> Returns if the authenticating user is blocking a target user. Will return the blocked user's object if a block exists, and error with a HTTP 404 response code otherwise. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/blocks/create">POST blocks/create</a> </td> <td class="views-field views-field-body"> Blocks the specified user from following the authenticating user. In addition the blocked user will not show in the authenticating users mentions or timeline (unless retweeted by another user). If a follow or friend relationship exists it is destroyed. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/blocks/destroy">POST blocks/destroy</a> </td> <td class="views-field views-field-body"> Un-blocks the user specified in the ID parameter for the authenticating user. Returns the un-blocked user in the requested format when successful. If relationships existed before the block was instated, they will not be restored. </td> </tr> </tbody> </table> <table class="views-table cols-1"> <caption><a id="spam-reporting"></a><strong>Spam Reporting</strong><p> These methods are used to report user accounts as spam accounts. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/report_spam">POST report_spam</a> </td> <td class="views-field views-field-body"> The user specified in the id is blocked by the authenticated user and reported as a spammer. </td> </tr> </tbody> </table> <table class="views-table cols-4"> <caption><a id="oauth"></a><strong>OAuth</strong><p> Twitter uses OAuth for authentication. Be sure and read about <a href="https://web.archive.org/web/20111109103742/https://dev.twitter.com/docs/auth/oauth">Using OAuth 1.0a</a>. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/oauth/authenticate">GET oauth/authenticate</a> </td> <td class="views-field views-field-body"> 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 Sign in with Twitter authentication flow. The method will use the currently logged in user as the... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/oauth/authorize">GET oauth/authorize</a> </td> <td class="views-field views-field-body"> Allows a Consumer application to use an OAuth Request Token to request user authorization. This method fulfills Section 6.2 of the OAuth 1.0 authentication flow. Desktop applications must use this method (and cannot use GET oauth/authenticate). Please use HTTPS for this method, and all other OAuth... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/oauth/access_token">POST oauth/access_token</a> </td> <td class="views-field views-field-body"> 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... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/oauth/request_token">POST oauth/request_token</a> </td> <td class="views-field views-field-body"> Allows a Consumer application to obtain an OAuth Request Token to request user authorization. This method fulfills Section 6.1 of the OAuth 1.0 authentication flow. It is strongly recommended you use HTTPS for all OAuth authorization steps. Usage Note: Only ASCII values are accepted for the... </td> </tr> </tbody> </table> <table class="views-table cols-3"> <caption><a id="help"></a><strong>Help</strong><p> These methods assist you in working & debugging with the Twitter API. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/help/test">GET help/test</a> </td> <td class="views-field views-field-body"> Returns the string "ok" in the requested format with a 200 OK HTTP status code. This method is great for sending a HEAD request to determine our servers current time. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/help/configuration">GET help/configuration</a> </td> <td class="views-field views-field-body"> 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. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/help/languages">GET help/languages</a> </td> <td class="views-field views-field-body"> Returns the list of languages supported by Twitter along with their ISO 639-1 code. The ISO 639-1 code is the two letter value to use if you include lang with any of your requests. </td> </tr> </tbody> </table> <table class="views-table cols-2"> <caption><a id="legal"></a><strong>Legal</strong><p> API Methods to address legal issues in your applications. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/legal/privacy">GET legal/privacy</a> </td> <td class="views-field views-field-body"> Returns Twitter's Privacy Policy in the requested format. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/legal/tos">GET legal/tos</a> </td> <td class="views-field views-field-body"> Returns the Twitter Terms of Service in the requested format. These are not the same as the Developer Rules of the Road. </td> </tr> </tbody> </table> <table class="views-table cols-25"> <caption><a id="deprecated"></a><strong>Deprecated</strong><p> These methods, while functional, are eventually being removed from the platform. Most methods will have functional or superior equivalents. </p></caption> <thead> <tr> <th class="views-field views-field-title"> Resource </th> <th class="views-field views-field-body"> Description </th> </tr> </thead> <tbody> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/delete/%3Auser/%3Alist_id/members">DELETE :user/:list_id/members</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/members/destroy. Please update your applications with the new endpoint. Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list. Usage Note: clients who can not issue... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/delete/%3Auser/%3Alist_id/subscribers">DELETE :user/:list_id/subscribers</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/subscribers/destroy. Please update your applications with the new endpoint. Unsubscribes the authenticated user form the specified list. Usage Note: clients who can not issue DELETE requests can POST with the added parameter _method=... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/delete/%3Auser/lists/%3Aid">DELETE :user/lists/:id</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/destroy. Please update your applications with the new endpoint. Deletes the specified list. Must be owned by the authenticated user. Usage Note: clients who can not issue DELETE requests can POST with the added parameter _method=DELETE. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/%3Alist_id/members">GET :user/:list_id/members</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/members. Please update your applications with the new endpoint. Returns the members of the specified list. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/%3Alist_id/members/%3Aid">GET :user/:list_id/members/:id</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/members/show. Please update your applications with the new endpoint. Check if a user is a member of the specified list. Returns the user indicated by :id if the user is a member of the list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/%3Alist_id/subscribers">GET :user/:list_id/subscribers</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/subscribers. Please update your applications with the new endpoint. Returns the subscribers of the specified list. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/%3Alist_id/subscribers/%3Aid">GET :user/:list_id/subscribers/:id</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/subscribers/show. Please update your applications with the new endpoint. Check if a user is a subscriber of the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/lists">GET :user/lists</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists. Please update your applications with the new endpoint. List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user who's lists are being returned. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/lists/%3Aid">GET :user/lists/:id</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/show. Please update your applications with the new endpoint. Show the specified list. Private lists will only be shown if the authenticated user owns the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/lists/%3Aid/statuses">GET :user/lists/:id/statuses</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/statuses. Please update your applications with the new endpoint. Show the tweet timeline for members of the specified list. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/lists/memberships">GET :user/lists/memberships</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/memberships. Please update your applications with the new endpoint. List the lists the specified user has been added to. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/%3Auser/lists/subscriptions">GET :user/lists/subscriptions</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET lists/subscriptions. Please update your applications with the new endpoint. List the lists the specified user follows. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/geo/nearby_places">GET geo/nearby_places</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by geo/search. Please update your applications with the new endpoint. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/followers">GET statuses/followers</a> </td> <td class="views-field views-field-body"> This method is deprecated as it will only return information about users who have Tweeted recently. It is not a functional way to retrieve all of a users followers. Instead of using this method use a combination of GET followers/ids and GET users/lookup. Returns the authenticating user's followers... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/friends">GET statuses/friends</a> </td> <td class="views-field views-field-body"> This method is deprecated as it will only return information about users who have Tweeted recently. It is not a functional way to retrieve all of a users followers. Instead of using this method use a combination of GET friends/ids and GET users/lookup. Returns a user's friends, each with current... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/statuses/friends_timeline">GET statuses/friends_timeline</a> </td> <td class="views-field views-field-body"> 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... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/trends">GET trends</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET trends/:woeid. Please update your applications with the new endpoint. Returns the top ten topics that are currently trending on Twitter. The response includes the time of the request, the name of each trend, and the url to the Twitter Search... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/get/trends/current">GET trends/current</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by GET trends/:woeid. Please update your applications with the new endpoint. Returns the current top 10 trending topics on Twitter. The response includes the time of the request, the name of each trending topic, and query used on Twitter Search... </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/%3Auser/%3Alist_id/create_all">POST :user/lists/:list_id/create_all</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/members/create_all. Please update your applications with the new endpoint. Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add... </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/%3Auser/%3Alist_id/members">POST :user/:list_id/members</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/members/create. Please update your applications with the new endpoint. Add a member to a list. The authenticated user must own the list to be able to add members to it. Lists are limited to having 500 members. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/%3Auser/%3Alist_id/subscribers">POST :user/:list_id/subscribers</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/subscribers/create. Please update your applications with the new endpoint. Make the authenticated user follow the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/%3Auser/lists">POST :user/lists</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/create. Please update your applications with the new endpoint. Creates a new list for the authenticated user. Accounts are limited to 20 lists. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/%3Auser/lists/%3Aid">POST :user/lists/:id</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST lists/update. Please update your applications with the new endpoint. Updates the specified list. </td> </tr> <tr class="even"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/1/post/account/update_delivery_device">POST account/update_delivery_device</a> </td> <td class="views-field views-field-body"> Sets which device Twitter delivers updates to for the authenticating user. Sending none as the device parameter will disable SMS updates. </td> </tr> <tr class="odd"> <td class="views-field views-field-title"> <a href="/web/20111109103742/https://dev.twitter.com/docs/api/post-accountupdate_location">POST account/update_location</a> </td> <td class="views-field views-field-body"> This method is deprecated and has been replaced by POST account/update_profile. Please update your applications with the new endpoint. Sets the value of the profile location field for the authenticating user. </td> </tr> </tbody> </table> </div> </div> </div> </div> </div> <div id="footer-outer"> <div id="footer"> <a href="https://web.archive.org/web/20111109103742/http://twitter.com/twitterapi" data-show-count="false" class="twitter-follow-button" data-text-color="999999" data-link-color="0080A6">Follow @twitterapi</a><ul class="menu"><li class="leaf first"><a href="/web/20111109103742/https://dev.twitter.com/terms/api-terms" title="Developer Rules of the Road">API Terms</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/status" title="Twitter API Status">API Status</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/blog" title="Twitter Developer blog">Blog</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/discussions" title="Twitter Development discussions">Discussions</a></li> <li class="leaf"><a href="/web/20111109103742/https://dev.twitter.com/docs" title="Twitter development documentation">Documentation</a></li> <li class="leaf last"><a href="https://web.archive.org/web/20111109103742/http://www.acquia.com/" title="Acquia">A Drupal community site supported by Acquia</a></li> </ul> </div> </div> </div><script type="text/javascript"> <![CDATA[//><!]]> </script> </body> </html>

CINXE.COM

REST API Resources | Twitter Developers