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=twitterdev

Example Response

[
  {
    "created_at": "Tue May 14 21:22:43 +0000 2019",
    "id": 1128410337504571394,
    "id_str": "1128410337504571394",
    "text": "Twitter wants to rebuild trust with developers via @TwitterDev https://t.co/FRSAgwc3d0",
    "truncated": false,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "user_mentions": [
        {
          "screen_name": "TwitterDev",
          "name": "Twitter Dev",
          "id": 2244994945,
          "id_str": "2244994945",
          "indices": [
            51,
            62
          ]
        }
      ],
      "urls": [
        {
          "url": "https://t.co/FRSAgwc3d0",
          "expanded_url": "https://venturebeat.com/2019/05/14/twitter-opens-developers-labs-program-to-test-new-api-products/",
          "display_url": "venturebeat.com/2019/05/14/twi…",
          "indices": [
            63,
            86
          ]
        }
      ]
    },
    "source": "<a href="http://twitter.com" rel="nofollow">Twitter Web Client</a>",
    "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,
    "in_reply_to_screen_name": null,
    "user": {
      "id": 46709686,
      "id_str": "46709686",
      "name": "Emil Protalinski",
      "screen_name": "EPro",
      "location": "",
      "description": "News Editor @VentureBeat Formerly @TheNextWeb @ZDNet @CNET @TechSpot @ArsTechnica",
      "url": "https://t.co/PXd4ee2JqF",
      "entities": {
        "url": {
          "urls": [
            {
              "url": "https://t.co/PXd4ee2JqF",
              "expanded_url": "https://keybase.io/epro",
              "display_url": "keybase.io/epro",
              "indices": [
                0,
                23
              ]
            }
          ]
        },
        "description": {
          "urls": []
        }
      },
      "protected": false,
      "followers_count": 9582,
      "friends_count": 151,
      "listed_count": 709,
      "created_at": "Fri Jun 12 18:08:21 +0000 2009",
      "favourites_count": 520,
      "utc_offset": null,
      "time_zone": null,
      "geo_enabled": false,
      "verified": true,
      "statuses_count": 8747,
      "lang": "en",
      "contributors_enabled": false,
      "is_translator": false,
      "is_translation_enabled": null,
      "profile_background_color": "null",
      "profile_background_image_url": "null",
      "profile_background_image_url_https": "null",
      "profile_background_tile": nulll,
      "profile_image_url": "null",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/942858479592554497/BbazLO9L_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1497491515",
      "profile_link_color": "null",
      "profile_sidebar_border_color": "null",
      "profile_sidebar_fill_color": "null",
      "profile_text_color": "null",
      "profile_use_background_image": null,
      "has_extended_profile": null,
      "default_profile": false,
      "default_profile_image": false,
      "following": false,
      "follow_request_sent": false,
      "notifications": false,
      "translator_type": "regular"
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "is_quote_status": false,
    "retweet_count": 4,
    "favorite_count": 5,
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "lang": "en"
  },
  {
    "created_at": "Tue May 14 21:16:34 +0000 2019",
    "id": 1128408788258529281,
    "id_str": "1128408788258529281",
    "text": "We’re really excited to open a new chapter with developers 👇🏻 https://t.co/xmkwkRbzvU",
    "truncated": false,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "user_mentions": [],
      "urls": [
        {
          "url": "https://t.co/xmkwkRbzvU",
          "expanded_url": "https://twitter.com/twitterdev/status/1128357926823976960",
          "display_url": "twitter.com/twitterdev/sta…",
          "indices": [
            62,
            85
          ]
        }
      ]
    },
    "source": "<a href="http://twitter.com/download/iphone" rel="nofollow">Twitter for iPhone</a>",
    "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,
    "in_reply_to_screen_name": null,
    "user": {
      "id": 37290907,
      "id_str": "37290907",
      "name": "bruce falck 👅🦗🤡🚗🇿🇦🗽",
      "screen_name": "boo",
      "location": "San Francisco, CA",
      "description": "Problem solver, Revenue Products lead at Twitter",
      "url": "https://t.co/7IDoW8iFLm",
      "entities": {
        "url": {
          "urls": [
            {
              "url": "https://t.co/7IDoW8iFLm",
              "expanded_url": "https://twitter.com",
              "display_url": "twitter.com",
              "indices": [
                0,
                23
              ]
            }
          ]
        },
        "description": {
          "urls": []
        }
      },
      "protected": false,
      "followers_count": 5843,
      "friends_count": 2113,
      "listed_count": 110,
      "created_at": "Sat May 02 21:48:49 +0000 2009",
      "favourites_count": 7216,
      "utc_offset": null,
      "time_zone": null,
      "geo_enabled": true,
      "verified": true,
      "statuses_count": 3362,
    "lang": "en",
    "contributors_enabled": false,
    "is_translator": false,
    "is_translation_enabled": null,
      "profile_background_color": "null",
      "profile_background_image_url": "null",
      "profile_background_image_url_https": "null",
      "profile_background_tile": nulll,
      "profile_image_url": "null",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/942858479592554497/BbazLO9L_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1497491515",
      "profile_link_color": "null",
      "profile_sidebar_border_color": "null",
      "profile_sidebar_fill_color": "null",
      "profile_text_color": "null",
      "profile_use_background_image": null,
      "has_extended_profile": null,
      "default_profile": false,
      "default_profile_image": false,
      "following": false,
      "follow_request_sent": false,
      "notifications": false,
      "translator_type": "regular"
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "is_quote_status": true,
    "quoted_status_id": 1128357926823976960,
    "quoted_status_id_str": "1128357926823976960",
    "quoted_status": {
      "created_at": "Tue May 14 17:54:28 +0000 2019",
      "id": 1128357926823976960,
      "id_str": "1128357926823976960",
      "text": "📣We’re launching Twitter Developer Labs in the coming weeks so we can build the future of our API together with tho… https://t.co/OVUiDiZqep",
      "truncated": true,
      "entities": {
        "hashtags": [],
        "symbols": [],
        "user_mentions": [],
        "urls": [
          {
            "url": "https://t.co/OVUiDiZqep",
            "expanded_url": "https://twitter.com/i/web/status/1128357926823976960",
            "display_url": "twitter.com/i/web/status/1…",
            "indices": [
              117,
              140
            ]
          }
        ]
      },
      "source": "<a href="https://mobile.twitter.com" rel="nofollow">Twitter Web App</a>",
      "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,
      "in_reply_to_screen_name": null,
      "user": {
        "id": 2244994945,
        "id_str": "2244994945",
        "name": "Twitter Dev",
        "screen_name": "TwitterDev",
        "location": "Internet",
        "description": "Your official source for Twitter Platform news, updates & events. Need technical help? Visit https://t.co/mGHnxZU8c1 ⌨️ #TapIntoTwitter",
        "url": "https://t.co/FGl7VOULyL",
        "entities": {
          "url": {
            "urls": [
              {
                "url": "https://t.co/FGl7VOULyL",
                "expanded_url": "https://developer.twitter.com/",
                "display_url": "developer.twitter.com",
                "indices": [
                  0,
                  23
                ]
              }
            ]
          },
          "description": {
            "urls": [
              {
                "url": "https://t.co/mGHnxZU8c1",
                "expanded_url": "https://twittercommunity.com/",
                "display_url": "twittercommunity.com",
                "indices": [
                  93,
                  116
                ]
              }
            ]
          }
        },
        "protected": false,
        "followers_count": 502011,
        "friends_count": 1472,
        "listed_count": 1510,
        "created_at": "Sat Dec 14 04:35:55 +0000 2013",
        "favourites_count": 2203,
        "utc_offset": null,
        "time_zone": null,
        "geo_enabled": true,
        "verified": true,
        "statuses_count": 3393,
        "lang": "en",
        "contributors_enabled": false,
      "is_translator": false,
      "is_translation_enabled": null,
        "profile_background_color": "null",
        "profile_background_image_url": "null",
        "profile_background_image_url_https": "null",
        "profile_background_tile": nulll,
        "profile_image_url": "null",
        "profile_image_url_https": "https://pbs.twimg.com/profile_images/942858479592554497/BbazLO9L_normal.jpg",
        "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1497491515",
        "profile_link_color": "null",
        "profile_sidebar_border_color": "null",
        "profile_sidebar_fill_color": "null",
        "profile_text_color": "null",
        "profile_use_background_image": null,
        "has_extended_profile": null,
        "default_profile": false,
        "default_profile_image": false,
        "following": false,
        "follow_request_sent": false,
        "notifications": false,
        "translator_type": "regular"
      },
      "geo": null,
      "coordinates": null,
      "place": null,
      "contributors": null,
      "is_quote_status": false,
      "retweet_count": 127,
      "favorite_count": 282,
      "favorited": false,
      "retweeted": false,
      "possibly_sensitive": false,
      "lang": "en"
    },
    "retweet_count": 38,
    "favorite_count": 156,
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "lang": "en"
  }
]