Recently Updated Documentation

May 3, 2012
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...
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...
April 25, 2012
Document Description
Which timezone is used on date fields within Tweets and other Twitter data? The created_at field of Tweets and other objects on Twitter are stored in UTC/coordinated universal time, see http://en.wikipedia.org/wiki/Coordinated_Universal_Time for more information. The oauth_timestamp field used in OAuth 1.0A requests is in UTC-based epoch time in seconds. See http://en....
April 23, 2012
Document Description
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 link my Facebook and Twitter accounts? We can't help with questions about the Twitter service link with Facebook here. If you're having issues, please read these articles and contact @Support if necessary. I'm having trouble using Twitter with Facebook How to use Twitter and Facebook
How do I get support for my account, the Twitter website, or Twitter for my mobile device? The Twitter Help Center is the ideal location for getting support with your Twitter account, the Twitter website, or Twitter for your mobile device. If you have feature requests, ideas, or complaints about the Twitter service, you should direct them via DM to @support or use the forms available to...
Things Every Developer Should Know Tweet IDs are enormous and break Javascript Use the id_str field instead of id whenever present to stay safe. Your web browser/Javascript interpreter/JSON consumer may munge our large integer-based ids which is why it's recommended to use the string representation. See Twitter IDs, JSON and...
April 18, 2012
Document Description
POST report_spam The user specified in the id is blocked by the authenticated user and reported as a spammer.
POST blocks/destroy Un-blocks the user specified in the ID parameter for the authenticating user. Returns the un-blocked user in the requested format when successful. If relationships existed before the block was instated, they will not be restored.
POST blocks/create Blocks the specified user from following the authenticating user. In addition the blocked user will not show in the authenticating users mentions or timeline (unless retweeted by another user). If a follow or friend relationship exists it is destroyed.
GET blocks/exists Returns if the authenticating user is blocking a target user. Will return the blocked user's object if a block exists, and error with a HTTP 404 response code otherwise.
GET blocks/blocking Returns an array of user objects that the authenticating user is blocking. Consider using GET blocks/blocking/ids with GET users/lookup instead of this method.
GET account/verify_credentials Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not. Use this method to test if supplied user credentials are valid.
POST lists/members/create Add a member to a list. 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.
GET lists/members Returns the members of the specified list. Private list members will only be shown if the authenticated user owns the specified list.
GET lists/members/show Check if the specified user is a member of the specified list.
GET lists/subscribers/show Check if the specified user is a subscriber of the specified list. Returns the user if they are subscriber.
GET lists/subscribers Returns the subscribers of the specified list. Private list subscribers will only be shown if the authenticated user owns the specified list.
GET users/suggestions/:slug/members.format Access the users in a given category of the Twitter suggested user list and return their most recent status if they are not a protected user.
GET users/contributors Returns an array of users who can contribute to the specified account.