Post, retrieve and engage with Tweets
API Reference contents
POST statuses/update
POST statuses/destroy/:id
GET statuses/show/:id
GET statuses/oembed
GET statuses/lookup
POST statuses/retweet/:id
POST statuses/unretweet/:id
GET statuses/retweets/:id
GET statuses/retweets_of_me
GET statuses/retweeters/ids
POST favorites/create
POST favorites/destroy
GET favorites/list
POST statuses/update_with_media (deprecated)
GET favorites/list¶
Note: favorites are now known as likes.
Returns the 20 most recent Tweets liked by the authenticating or specified user.
Resource URL¶
https://api.twitter.com/1.1/favorites/list.json
Resource Information¶
| Response formats | JSON |
| Requires authentication? | Yes |
| Rate limited? | Yes |
| Requests / 15-min window (user auth) | 75 |
| Requests / 15-min window (app auth) | 75 |
Parameters¶
| Name | Required | Description | Default Value | Example |
| user_id | optional | The ID of the user for whom to return results. | 12345 | |
| screen_name | optional | The screen name of the user for whom to return results. | noradio | |
| count | optional | Specifies the number of records to retrieve. Must be less than or equal to 200; defaults to 20. The value of count is best thought of as a limit to the number of Tweets to return because suspended or deleted content is removed after the count has been applied. | 5 | |
| since_id | optional | Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available. | 12345 | |
| max_id | optional | Returns results with an ID less than (that is, older than) or equal to the specified ID. | 54321 | |
| include_entities | optional | The entities node will be omitted when set to false . | false |
Example Request¶
GET https://api.twitter.com/1.1/favorites/list.json?count=2&screen_name=episod
Example Response¶
[
{
"coordinates": null,
"truncated": false,
"favorited": true,
"created_at": "Tue Sep 04 15:55:52 +0000 2012",
"id_str": "243014525132091393",
"in_reply_to_user_id_str": null,
"entities": {
"urls": [
],
"hashtags": [
],
"user_mentions": [
]
},
"text": "Note to self: don't die during off-peak hours on a holiday weekend.",
"contributors": null,
"id": 243014525132091393,
"retweet_count": 0,
"in_reply_to_status_id_str": null,
"geo": null,
"retweeted": false,
"in_reply_to_user_id": null,
"in_reply_to_screen_name": null,
"source": "web",
"user": {
"profile_sidebar_fill_color": "252429",
"profile_background_tile": true,
"profile_sidebar_border_color": "181A1E",
"name": "Sean Cook",
"profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG",
"location": "San Francisco",
"created_at": "Sat May 09 17:58:22 +0000 2009",
"follow_request_sent": false,
"is_translator": false,
"id_str": "38895958",
"profile_link_color": "2FC2EF",
"entities": {
"description": {
"urls": [
]
}
},
"favourites_count": 594,
"url": null,
"default_profile": false,
"contributors_enabled": true,
"profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG",
"utc_offset": -28800,
"id": 38895958,
"listed_count": 191,
"profile_use_background_image": true,
"followers_count": 10659,
"protected": false,
"profile_text_color": "666666",
"lang": "en",
"profile_background_color": "1A1B1F",
"time_zone": "Pacific Time (US & Canada)",
"verified": false,
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png",
"description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ",
"geo_enabled": true,
"notifications": false,
"default_profile_image": false,
"friends_count": 1186,
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png",
"statuses_count": 2629,
"following": true,
"screen_name": "theSeanCook",
"show_all_inline_media": true
},
"place": {
"name": "San Francisco",
"country_code": "US",
"country": "United States",
"attributes": {
},
"url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json",
"id": "5a110d312052166f",
"bounding_box": {
"coordinates": [
[
[
-122.51368188,
37.70813196
],
[
-122.35845384,
37.70813196
],
[
-122.35845384,
37.83245301
],
[
-122.51368188,
37.83245301
]
]
],
"type": "Polygon"
},
"full_name": "San Francisco, CA",
"place_type": "city"
},
"in_reply_to_status_id": null
},
{
"coordinates": null,
"truncated": false,
"favorited": true,
"created_at": "Tue Sep 04 00:17:11 +0000 2012",
"id_str": "242778296117514240",
"in_reply_to_user_id_str": null,
"entities": {
"urls": [
],
"hashtags": [
],
"user_mentions": [
]
},
"text": "TWIT NPC. TWIT DUNGEONMASTER.",
"contributors": null,
"id": 242778296117514240,
"retweet_count": 1,
"in_reply_to_status_id_str": null,
"geo": null,
"retweeted": false,
"in_reply_to_user_id": null,
"in_reply_to_screen_name": null,
"source": "Twitter for Android",
"user": {
"profile_sidebar_fill_color": "DDEEF6",
"profile_background_tile": false,
"profile_sidebar_border_color": "C0DEED",
"name": "REGIS",
"profile_image_url": "http://a0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg",
"location": "",
"created_at": "Wed May 07 19:27:16 +0000 2008",
"follow_request_sent": false,
"is_translator": false,
"id_str": "14690653",
"profile_link_color": "009999",
"entities": {
"description": {
"urls": [
]
}
},
"favourites_count": 46407,
"url": null,
"default_profile": false,
"contributors_enabled": false,
"profile_image_url_https": "https://si0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg",
"utc_offset": -25200,
"id": 14690653,
"listed_count": 194,
"profile_use_background_image": true,
"followers_count": 4198,
"protected": false,
"profile_text_color": "333333",
"lang": "en",
"profile_background_color": "131516",
"time_zone": "Mountain Time (US & Canada)",
"verified": false,
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/530267284/11111.JPG",
"description": "Everything I tweet is or shall be.",
"geo_enabled": true,
"notifications": false,
"default_profile_image": false,
"friends_count": 200,
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/530267284/11111.JPG",
"statuses_count": 43345,
"following": true,
"screen_name": "regisl",
"show_all_inline_media": false
},
"place": null,
"in_reply_to_status_id": null
}
]