Recently Updated Documentation

July 26, 2012
Document Description
Twitter Cards Introduction Twitter cards make it possible for you to attach media experiences to Tweets that link to your content. Simply add a few lines of HTML to your webpages, and users who Tweet links to your content will have a "card" added to the Tweet that’s visible to all of their followers. As a...
July 25, 2012
Document Description
Entities Entities provide metadata and additional contextual information about content posted on Twitter. Entities are never divorced from the content they describe. After May 14th, 2012 Tweet Entities will be returned wherever Tweets are found in the API. Entities are instrumental in resolving URLs. Field...
July 24, 2012
Document Description
Why won't statuses/update let me post a link to a specific domain name? Some domain names get identified as spam or malware. If you believe that you should be able to validly use a domain name, see this support article for further instructions: My Website is Being Flagged as Malware or Spam! and email tcoabuse@twitter.com with details about your domain.
July 17, 2012
Document Description
GET statuses/mentions 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...
July 10, 2012
Document Description
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...
Partner Providers of Twitter Data Our partnerships with Gnip and DataSift are set up to offer access to the full Twitter Firehose. If you're hitting limits with the Streaming API (400 track keywords, 5,000 follow userids, and 25 0.1-360 degree locations) and are doing data analysis or building non-display applications, please...
July 6, 2012
Document Description
GET direct_messages/sent 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. You can request up to 200 direct messages per call, up to a maximum of 800 outgoing DMs. Important: This method requires an access...
GET direct_messages 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. You can request up to 200 direct messages per call, up to a maximum of 800 incoming DMs. Important: This method requires an access...
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 ColdFusion Erlang Java JavaScript .NET Objective-C /...
July 3, 2012
Document Description
Using the Twitter Search API The Twitter Search API is a dedicated API for running searches against the real-time index of recent Tweets. There are a number of important things to know before using the Search API which are explained below. Limitations The Search API is not complete index of all Tweets, but instead...
GET search Returns relevant 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...
June 20, 2012
Document Description
Streaming message types Public stream messages Blank lines Status deletion notices (delete) Location deletion notices (scrub_geo) Limit notices (limit) Withheld content notices (status_withheld, user_withheld) User stream messages Friends lists (friends) Events (event) Site stream messages Envelopes...
Tweets Also known as a Status Update, Tweets are the basic atomic unit of all things Twitter. Users create Tweets. Tweets can be embedded, replied to, favorited, unfavorited, retweeted, unretweeted and deleted. A retweet contains an embedded Tweet object within the "retweeted_status" attribute....
June 19, 2012
Document Description
Why are the Tweets I'm looking for not in Twitter Search, the Search API, or Search widgets? Twitter's search is optimized to serve relevant tweets to end-users in response to direct, non-recurring queries such as #hashtags, URLs, domains, and keywords. The Search API (which also powers Twitter's search widget) is an interface to this search engine. Our search service is not meant to be...
June 18, 2012
Document Description
Techniques for Live Tweet Curation Many real-time display integrations want to highlight specific curated Tweets. Perhaps you want to display the Tweets you've determined are the best on a display at a conference, or mark a collection of Tweets to be rendered along the bottom of the screen during a television show, or to build a...
OAuth The OAuth documentation has moved to OAuth
June 15, 2012
Document Description
Useful Links We Found 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 Tweeting with Node.js On Rendering Tweets...
June 7, 2012
Document Description
Developer Rules of the Road Last Update - 17th of May 2012 Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and discovering what's happening now. We want to empower our ecosystem partners to build valuable businesses around the information flowing...
June 6, 2012
Document Description
Follow Button The Follow Button is a small widget which allows users to easily follow a Twitter account from any webpage. The Follow Button uses the same implementation model as the Tweet Button, and its integration is just as simple. By using the Follow Button, you agree to the Developer Rules of the Road....
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...