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

https://api.twitter.com/1.1/favorites/destroy.json

Resource Information

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

Parameters

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

POST

https://api.twitter.com/1.1/favorites/destroy.json?id=243138128959913986

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": [
              0, 
              21
            ], 
            "url": "http://jakeboxer.com/"
          }
        ]
      }
    }, 
    "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": "http://a0.twimg.com/images/themes/theme5/bg.gif", 
    "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme5/bg.gif", 
    "profile_background_tile": false, 
    "profile_image_url": "http://a0.twimg.com/profile_images/1621757700/twitter_normal.png", 
    "profile_image_url_https": "https://si0.twimg.com/profile_images/1621757700/twitter_normal.png", 
    "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": "http://jakeboxer.com/", 
    "utc_offset": -18000, 
    "verified": false
  }
}