POST favorites/create/:id

Updated on Wed, 2012-04-18 11:19

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

This process invoked by this method is asynchronous. The immediately returned status 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/favorites/create/:id.format

Parameters

id required

The numerical ID of the desired status.

Example Values: 123

include_entities optional

When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more detail on entities.

Example Values: true

Example Request

POST

https://api.twitter.com/1/favorites/create/132256714090229760.json

POST Data

None

  1. {
  2.   "coordinates": null,
  3.   "truncated": false,
  4.   "favorited": false,
  5.   "created_at": "Fri Nov 04 00:43:52 +0000 2011",
  6.   "id_str": "132256714090229760",
  7.   "in_reply_to_user_id_str": "6253282",
  8.   "text": "@twitterapi Great *scraps mentions parsing from list*",
  9.   "contributors": null,
  10.   "id": 132256714090229760,
  11.   "in_reply_to_status_id_str": "132255030303666176",
  12.   "retweet_count": 0,
  13.   "geo": null,
  14.   "retweeted": false,
  15.   "in_reply_to_user_id": 6253282,
  16.   "source": "<a href=\"http://blog.schoentoon.com/twoons-related-blogs\" rel=\"nofollow\">Twoons</a>",
  17.   "user": {
  18.     "profile_sidebar_border_color": "eeeeee",
  19.     "profile_sidebar_fill_color": "efefef",
  20.     "name": "Schoentoon",
  21.     "profile_background_tile": true,
  22.     "location": "Equestria",
  23.     "profile_image_url": "http://a0.twimg.com/profile_images/1391890526/I_WANT_CAKE_normal.png",
  24.     "created_at": "Wed Feb 25 06:44:59 +0000 2009",
  25.     "profile_link_color": "009999",
  26.     "is_translator": false,
  27.     "follow_request_sent": false,
  28.     "id_str": "21843598",
  29.     "default_profile": false,
  30.     "url": "http://schoentoon.com",
  31.     "contributors_enabled": false,
  32.     "favourites_count": 34,
  33.     "id": 21843598,
  34.     "profile_image_url_https": "https://si0.twimg.com/profile_images/1391890526/I_WANT_CAKE_normal.png",
  35.     "utc_offset": 3600,
  36.     "profile_use_background_image": true,
  37.     "listed_count": 156,
  38.     "lang": "en",
  39.     "profile_text_color": "333333",
  40.     "followers_count": 764,
  41.     "protected": false,
  42.     "time_zone": "Amsterdam",
  43.     "verified": false,
  44.     "description": "C++ developer. I make people feel bad about using windows. Linux power user. Oh and I love @selenagomez.",
  45.     "notifications": false,
  46.     "profile_background_color": "131516",
  47.     "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme14/bg.gif",
  48.     "geo_enabled": true,
  49.     "profile_background_image_url": "http://a1.twimg.com/images/themes/theme14/bg.gif",
  50.     "statuses_count": 62419,
  51.     "default_profile_image": false,
  52.     "friends_count": 539,
  53.     "screen_name": "Schoentoon",
  54.     "show_all_inline_media": true,
  55.     "following": false
  56.   },
  57.   "in_reply_to_screen_name": "twitterapi",
  58.   "place": null,
  59.   "in_reply_to_status_id": 132255030303666176
  60. }