Post, retrieve and engage with Tweets

POST favorites/destroy

Note: favorites are now known as likes.

Unfavorites (un-likes) the Tweet specified in the ID parameter as the authenticating user. Returns the un-liked Tweet when successful.

The process invoked by this method is asynchronous. The immediately returned Tweet object may not indicate the resultant favorited 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

Name Required Description Default Value Example
id required The numerical ID of the Tweet to un-like   123
include_entities optional The entities node will be omitted when set to false .   false

Example Request

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

Example Response

{
  "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.rnrnChicken 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
  }
}