Recently Updated Documentation

May 22, 2013
Document Description
Calendar of API changes This page lists important upcoming dates for consumers of Twitter's APIs. The dates listed will be as specific as possible, but may not be exact for various reasons. Please continue to follow @twitterapi and the Twitter developer blog for announcements about the platform. Upcoming changes...
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. Code Text Description 200 OK Success...
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,...
Getting Started Getting Started with Cards Card and Content Attribution URL Crawling Twitter Cards and Open Graph Getting Started with Cards To get started with implementing the Cards markup, you'll want to specify the type of card for your content by adding the following HTML to the HEAD section...
Player Card This Card type requires special approval, and is not available for immediate approval at this time. The player card is for streaming media experiences such as video and audio, and allows you to present your content inside of an iframe within the Tweet. Unlike the photo and summary card, you...
Product Card This Card type requires special approval, and is not available for immediate approval at this time. The product card is a great way to better represent retail items on Twitter, and to drive sales. This Card type is designed to showcase your products via an image, a description, and allow you...
App Card This Card type is not yet widely available, though it should be within the next few weeks. At this time, it requires special approval. App Card is a great way to better represent mobile applications on Twitter and to drive installs. We designed the App Card to allow for a name, description and...
Gallery Card The gallery card allows you to represent collections of photos within a Tweet. This Card type is designed to let the user know that there's more than just a single image at the URL shared, but rather a gallery of related images. You can specify up to 4 different images to show in the gallery...
Photo Card The photo card puts the image front and center in the Tweet: Web Mobile To define a photo card experience, set your card type to "photo" and provide a twitter:image. Twitter...
May 20, 2013
Document Description
Twitter Libraries These libraries, while not necessarily tested by Twitter, should support Twitter API v1.1. Want your library to be included in this index or need to update the details we have? Submit your library for inclusion! Libraries built for the Twitter Platform Clojure twitter-api by @adamjwynne and...
Users Users can be anyone or anything. They tweet, follow, create lists, have a home_timeline, can be mentioned, and can be looked up in bulk. (JSON) Field Guide Consumers of Users should tolerate the addition of new fields and variance in ordering of fields with ease. Not all fields appear in all...
May 17, 2013
Document Description
When will API 1.0 be retired? We will begin to temporarily turn off the endpoints for API v1.0 starting March 5th, 2013 for a series of "blackout tests". See Planning for API v1’s Retirement for more information. Final retirement is currently scheduled for June 11, 2013.
What does the retirement of API v1 entail? API v1 is currently set to retire on June 11, 2013. After retirement (and during the blackout tests leading up to retirement), you can expect the following: Authenticated & unauthenticated requests to api.twitter.com/1/* will receive HTTP 410 Gone. Use API v1.1 instead. Requests to search....
May 8, 2013
Document Description
Security Best Practices Introduction A successful Twitter application is likely to get some attention. Most of that attention will be good: users singing your praises, other developers complimenting your programming chops. Some of that attention, though, might be negative. As Twitter has increased in popularity, the...
May 7, 2013
Document Description
GET statuses/retweeters/ids Returns a collection of up to 100 user IDs belonging to users who have retweeted the tweet specified by the id parameter. This method offers similar data to GET statuses/retweets/:id and replaces API v1's GET statuses/:id/retweeted_by/ids method.
Large Image Summary Card In addition to our regular Summary Card, we also have a format that allows you to feature a larger image above the title and description of the Card. The regular Summary Card features a thumbnail image in the upper right hand corner of the Card, but if you want to more prominently feature your...
Overview: Version 1.1 of the Twitter API Version 1.1 of the Twitter API is the first major update of the API since its launch. We're excited about what it means for developers and we've captured all the meaningful changes here so you don't miss a thing. Improved rate limits JSON support only Authentication required on all...
May 6, 2013
Document Description
埋め込みタイムライン English | 日本語 概要 「埋め込みタイムライン」は簡単にTwitterのタイムラインを自分のサイトに表示できるツールです。タイムラインはリアルタイムで更新され、タイムライン上から直接、返信、リツイート、お気に入りに登録することができます。twitter.comのウィジェット設定から簡単に作成可能です。 埋め込みタイムラインのタイプ ユーザー、お気に入り、リスト、検索結果、ハッシュタグのタイムラインを埋め込むことができます。 ユーザータイムライン 公開されているものであれば、どのユーザーのタイムラインでも埋め込むことができます。下記はこのページに埋め込みされた@...
Embedded Timelines English | 日本語 Overview Embeddable timelines make it easy to syndicate any public Twitter timeline to your website with one line of code. Just like timelines on twitter.com, embeddable timelines are interactive and enable your visitors to reply, Retweet, and favorite Tweets directly from your...
May 1, 2013
Document Description
JavaScript Interfaces for Twitter for Websites By using Web Intents Javascript Events, you agree to the Developer Rules of the Road. If you're integrating your site with Twitter using Twitter for Websites and Web Intents, you can enhance your application using JavaScript functions and events. Twitter for Websites products—Tweet buttons,...