POST favorites/destroy

Note: the like action was known as favorite before November 3, 2015; the historical naming remains in API methods and object properties.

Un-likes the status specified in the ID parameter as the authenticating user. Returns the un-liked status in the requested format when successful.

This process invoked by this method is asynchronous. The immediately returned status may not indicate the resultant liked status of the Tweet. A 200 OK response from this method will indicate whether the intended action was successful or not.

Resource URL

Resource Information

Response formats
Requires authentication?
Yes (user context only)
Rate limited?


id required

The numerical ID of the desired status.

Example Values: 123

include_entities optional

The entities node will be omitted when set to false.

Example Values: false

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request


Example Result

  "contributors": null, 
  "coordinates": null, 
  "created_at": "Wed Sep 05 00:07:01 +0000 2012", 
  "entities": {
    "hashtags": [], 
    "urls": [], 
    "user_mentions": []
  "favorited": false, 
  "geo": null, 
  "id": 243138128959913986, 
  "id_str": "243138128959913986", 
  "in_reply_to_screen_name": null, 
  "in_reply_to_status_id": null, 
  "in_reply_to_status_id_str": null, 
  "in_reply_to_user_id": null, 
  "in_reply_to_user_id_str": null, 
  "place": null, 
  "retweet_count": 0, 
  "retweeted": false, 
  "source": "Twitter for Mac", 
  "text": "That feel when you accidentally type Bash commands into Campfire, and you also make a typo in them.", 
  "truncated": false, 
  "user": {
    "contributors_enabled": false, 
    "created_at": "Wed Apr 23 20:32:35 +0000 2008", 
    "default_profile": false, 
    "default_profile_image": false, 
    "description": "Developer at GitHub in San Francisco, CA.\r\n\r\nChicken nuggets is like my family.", 
    "entities": {
      "description": {
        "urls": []
      "url": {
        "urls": [
            "display_url": null, 
            "expanded_url": null, 
            "indices": [
            "url": ""
    "favourites_count": 187, 
    "follow_request_sent": false, 
    "followers_count": 714, 
    "following": false, 
    "friends_count": 327, 
    "geo_enabled": true, 
    "id": 14500363, 
    "id_str": "14500363", 
    "is_translator": false, 
    "lang": "en", 
    "listed_count": 39, 
    "location": "San Francisco, CA", 
    "name": "Jake Boxer", 
    "notifications": false, 
    "profile_background_color": "352726", 
    "profile_background_image_url": "", 
    "profile_background_image_url_https": "", 
    "profile_background_tile": false, 
    "profile_image_url": "", 
    "profile_image_url_https": "", 
    "profile_link_color": "D02B55", 
    "profile_sidebar_border_color": "829D5E", 
    "profile_sidebar_fill_color": "99CC33", 
    "profile_text_color": "3E4415", 
    "profile_use_background_image": true, 
    "protected": false, 
    "screen_name": "jake_boxer", 
    "show_all_inline_media": false, 
    "statuses_count": 5398, 
    "time_zone": "Eastern Time (US & Canada)", 
    "url": "", 
    "utc_offset": -18000, 
    "verified": false