| 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... |
| 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... |
| 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. |
| GET statuses/oembed | Returns information allowing the creation of an embedded representation of a Tweet on third party sites. See the oEmbed specification for information about the response format. While this endpoint allows a bit of customization for the final appearance of the embedded Tweet, be aware that the... |
| Player Card | Player Card This Card type requires special approval, and is not available for auto-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... |
| Document | Description |
|---|---|
| Connecting to a streaming endpoint | Overview Authentication Connecting Disconnections Stalls Reconnecting Connection churn Rate limiting Best practices Test backoff strategies Issue alerts for multiple reconnects Handle DNS changes User Agent HTTP Error Codes Overview Establishing a connection to the... |
| Document | Description |
|---|---|
| App Card | 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,... |
| 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... |
| Document | Description |
|---|---|
| Product Card | Product Card This Card type requires special approval, and is not available for auto-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... |
| Gallery Card | 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... |
| Photo Card | 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... |
| Summary Card | Summary Card The summary card can be used for many kinds of web content, from blog posts and news articles, to products and restaurants. The screenshot below shows the expanded Tweet view for a New York Times article: Web Mobile... |
| 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. |
| 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.... |
| Cards Markup Tag Reference | The table in this section explains the OpenGraph fallback behavior for each Twitter tag. Overview of all Twitter Card Tags Property Card Value OpenGraph Fallback twitter:card all summary, photo,... |
| App Installs and Deep-Linking | Introduction One of the most important features in the new Cards is the ability to allow users to download your app (if the user doesn't already have it installed), or deep-link into your own app (if the app is already installed on the user's mobile device). The ability to enable app installs... |
| 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... |
