Recently Updated Documentation

April 3, 2012
Document Description
How do I get my account verified? This site is focused on programmatic uses of the Twitter Platform. We do not review nor approve any requests for the closed account verification program. Please do not use this site to request verification. If you have any questions about verification, see FAQs about Verification and reach out to...
April 2, 2012
Document Description
How do I report bugs and request features? Before filing an issue to report a bug or request a feature, please: Check the Issue Tracker for similar issues or requests. If you find what you're looking for, subscribe to the issue to indicate your interest. Search the Discussions for similar issues and requests. If you find an active topic...
What am I doing wrong? Troubleshooting with the API is usually done with these steps: Examine the HTTP response closely: the status code you received back, the message that accompanies that code, the HTTP headers in the response, and the response body itself -- the response body usually contains the most specific...
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...
March 30, 2012
Document Description
How do I contest an application suspension? See How To Appeal an Application Suspension from our support center.
March 29, 2012
Document Description
What does HTTP status code 0 mean? If you're making requests to the Twitter platform and receive an HTTP status code "0," it means that the request never made it to our servers. Investigate whether your HTTP library, programming language, system environment, network and/or proxies are configured to allow traffic over HTTP and HTTPS...
What's a placeholder URL? How do I set my callback URL? In OAuth 1.0a, you're required to send an explicit oauth_callback value on every request to POST oauth/request_token, regardless of any pre-registered callback you may have associated with your application or if you're going to be performing out-of-band OAuth (for which you'd provide an...
March 26, 2012
Document Description
POST lists/members/destroy_all Removes multiple members from 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 remove members from it. Note that lists can't have more than 500 members, and you are limited to removing up to 100 members to a list at a...
POST lists/members/create_all 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...
March 22, 2012
Document Description
What is the version of the REST API? In the API documentation there is a version place marker in the example request URL. Currently only one version of the API exists, that version is 1. This means any REST API queries will be of the format: https://api.twitter.com/1/statuses/user_timeline.json. The Streaming API is currently on...
March 20, 2012
Document Description
GET blocks/blocking/ids Returns an array of numeric user ids the authenticating user is blocking.
March 13, 2012
Document Description
How do I allow additional users to maintain my application record? This is not supported at this time and only one user account can maintain an application record. It's recommended to ensure that applications belong to accounts that are directly in an organization or developer's control. See How do I transfer my application to another account? if it is necessary...
How do I transfer my application to another account? To get the process started, email api@twitter.com from the email address associated with the account currently owning the application. Include the @username you want to become the owner once the process is complete and any other explanation you may think is necessary. It can take a few days to...
March 12, 2012
Document Description
I set my app to "read, write, and direct messages" but it still won't let me read my direct messages; why? Permissions set at the application level are effective only for access tokens generated after the requested permission level is set. If you generated an access token while the permission level was still set to read-only or just read & write, you'll need to renegotiate the access token through...
What consequences are there to resetting my consumer key and secret? If your consumer key and secret become compromised for any reason, you may need to reset it to regain secure control of your application's identity and the actions taken in its name. Resetting your consumer key does not reset the strings representing your users (their "access tokens") but does...
What guidelines are there for using Twitter content (such as Tweets) in advertising campaigns? The Developer Rules of the Road, section IV, part 3 describes the current rules around using Twitter content within advertising.
Is there an Advertising API for serving Twitter ads in my third party application? As of March 12, 2012 there is no Advertising API for serving Twitter's promoted products in third party applications.
Is there an Advertising API for posting ads to Twitter? As of March 12th, 2012 there is not yet an API allowing an advertiser to create or manage Promoted Products campaigns on Twitter. For updates on advertising with Twitter, follow the Twitter Advertising Blog: http://advertising.twitter.com
Why do my image uploads fail? The image update methods require multipart form data. They do not accept a URL to an image nor do they accept the raw image bytes. They instead require the data to be delivered in the form of a file upload filed as defined in RFC1867. The content-type attribute of the image field is checked for...
Why do I keep getting the wrong Tweet IDs? See Twitter IDs, JSON and Snowflake. This is an issue with JSON parsing of large integers -- by looking at/consuming the JSON the ID value is munged. Use id_str instead of id whenever possible.