| Document | Description |
|---|---|
| Deprecations - Spring 2012 | On May 14th, 2012 the following deprecations and platform adjustments will begin. See API Housekeeping for more information. Summary All non-versioned API endpoints, such as http://twitter.com/statuses/user_timeline, will cease functioning. See the full account of deprecated methods for a... |
| What do I do if my account is compromised, hacked, or used outside of my control? | If you're having any questions about the security of your account, please contact @Support through our Support Center at https://support.twitter.com/forms/hacked -- we cannot assist with account issues on this site. See My Account is Compromised/Hacked and I Can't Log In! and How to Connect... |
| Document | Description |
|---|---|
| What kind of data can I get from the API? | To explore the kind of data available to you in the API, browse the available resources and this field guide to the most commonly accessed platform objects. |
| How can I keep up with changes to the Twitter API? | There are a two 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. |
| 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... |
| Entities | Entities provide metadata and additional contextual information about content posted on Twitter. Entities are never divorced from the content they describe. After May 14th, 2012 Tweet Entities will be returned wherever Tweets are found in the API. Entities are instrumental in resolving URLs. Field... |
| 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... |
| Tweets | Also known as a Status Update, Tweets are the basic atomic unit of all things Twitter. Users create Tweets. Tweets can be embedded, replied to, favorited, unfavorited, retweeted, unretweeted and deleted. The "http://" at the beginning of URLs is a command to the browser. It stands for "head... |
| Document | Description |
|---|---|
| Follow Button | By using the Follow Button, you agree to the Developer Rules of the Road. Overview The Follow Button is a small widget which allows users to easily follow a Twitter account from any webpage. The Follow Button uses the same implementation model as the Tweet Button, and its integration is just... |
| Document | Description |
|---|---|
| Connecting to Twitter API using SSL | The preferred method of connecting to the Twitter API is over HTTPS. While both HTTPS and Non-HTTPS connections to the Twitter API are supported, communicating over SSL preserves user privacy by protecting information between the user and the Twitter API as it travels across the public Internet... |
| How do I properly navigate a timeline? | The Working with Timelines document describes the optimal way to obtain tweets from timelines such as GET statuses/home_timeline, GET statuses/mentions and GET statuses/user_timeline. The "count" parameter behaves more closely in concept to an "up to" parameter in that you'll receive up to the... |
| Document | Description |
|---|---|
| How do I keep from running into the rate limit? | Caching. We recommend that you cache API responses in your application or on your site if you expect high-volume usage. For example, don't try to call the Twitter API on every page load of your hugely popular website. Instead, call our API once a minute and save the response to your local server,... |
| 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.... |
| Document | Description |
|---|---|
| Using the Twitter Search API | The Twitter Search API is a dedicated API for running searches against the real-time index of recent Tweets. There are a number of important things to know before using the Search API which are explained below. Limitations The Search API is not complete index of all Tweets, but instead... |
| 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... |
| 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. |