| Document | Description |
|---|---|
| API Terms of Service: May 17, 2012 | Please Note: These terms are NOT current. Please read the current terms. Last Update: June 1, 2011 May 17, 2012. Return to the API Terms of Service: Archive. Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and... |
| 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... |
| GET oauth/authorize | 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... |
| 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... |
| POST oauth/request_token | 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... |
| Support | If you are having trouble, here is the recommended plan of action (in order): API Documentation The official Twitter documentation can be found on dev.twitter.com. Issues List Use our new Issue Tracker to see filed bugs and file bugs of your own. Please include as much detail as humanly possible.... |
| POST favorites/destroy | 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... |
| POST favorites/create | 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... |
| GET favorites/list | Returns the 20 most recent Tweets favorited by the authenticating or specified user. |
| GET statuses/show/:id | Returns a single Tweet, specified by the id parameter. The Tweet's author will also be embedded within the tweet. See Embeddable Timelines, Embeddable Tweets, and GET statuses/oembed for tools to render Tweets according to Display Requirements. |
| GET lists/all | 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. |
| Document | Description |
|---|---|
| Twitter Certified Products Program | The Twitter Certified Products Program helps businesses find some of the best products and services to thrive on Twitter. We certify leading solutions from the Twitter ecosystem for the needs of publishers, brands, and partners. We continually work with program members in the... |
| Document | Description |
|---|---|
| Twitter Certified Products Requirements | The terms below are requirements for all products in the Twitter Certified Products Program. Current and potential partners must fully adhere to these requirements for certification. We encourage you to audit your product against all of these terms before applying to the Twitter Certified... |
| Is my IP banned or blacklisted? | Being banned or blacklisted means the Twitter APIs will not respond to requests you make to them. You know if you have been blacklisted because the APIs will not respond to you at all. If this happens to you the first thing to do is stop any requests your application is making. Then see if you can... |
| Document | Description |
|---|---|
| GET statuses/firehose | This endpoint requires special permission to access. Returns all public statuses. Few applications require this level of access. Creative use of a combination of other resources and various access levels can satisfy nearly every application use case. |
| GET statuses/sample | Returns a small random sample of all public statuses. The Tweets returned by the default access level are the same, so if two different clients connect to this endpoint, they will see the same Tweets. |
| 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"... |
| Document | Description |
|---|---|
| Places | Places are specific, named locations with corresponding geo coordinates. They can be attached to Tweets by specifying a place_id when tweeting. Tweets associated with places are not necessarily issued from that location but could also potentially be about that location. Places can be created and... |
| Frequently Asked Questions | Frequent Asked Questions I'm receiving authentication errors when using TWRequest. What's going on? Do TWRequest and TWTweetComposeViewController calls automatically wrap urls in statuses updates? Why is my application attributed as "from iOS" instead of "from <my application>" on... |