POST favorites/create

 

Note: favorites are now known as likes.

Favorites (likes) the status specified in the ID parameter as the authenticating user. Returns the favorite status when successful.

The process invoked by this method is asynchronous. The immediately returned status object may not indicate the final 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/create.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 desired status.   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/create.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
  }
}