Create and manage lists

GET lists/subscriptions

Obtain a collection of the lists the specified user is subscribed to, 20 lists per page by default. Does not include the user's own lists.

Resource URL

https://api.twitter.com/1.1/lists/subscriptions.json

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes
Requests / 15-min window (user auth) 15
Requests / 15-min window (app auth) 15

Parameters

Name Required Description Default Value Example
user_id optional The ID of the user for whom to return results. Helpful for disambiguating when a valid user ID is also a valid screen name.
screen_name optional The screen name of the user for whom to return results. Helpful for disambiguating when a valid screen name is also a user ID.
count optional The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
cursor optional Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Cursoring for more information.

Example Request

GET https://api.twitter.com/1.1/lists/subscriptions.json?screen_name=twitterdev&count=1

Example Response

{
  "next_cursor": 1631626924518660544,
  "next_cursor_str": "1631626924518660544",
  "previous_cursor": 0,
  "previous_cursor_str": "0",
  "lists": [
    {
      "id": 1130185227375038465,
      "id_str": "1130185227375038465",
      "name": "Twitter API",
      "uri": "/twitterdev/lists/twitter-api",
      "subscriber_count": 0,
      "member_count": 2,
      "mode": "public",
      "description": "",
      "slug": "twitter-api",
      "full_name": "@twitterdev/twitter-api",
      "created_at": "Sun May 19 18:55:30 +0000 2019",
      "following": true,
      "user": {
        "id": 2244994945,
        "id_str": "2244994945",
        "name": "Twitter Dev",
        "screen_name": "TwitterDev",
        "location": "The Internet",
        "description": "",
        "url": null,
        "entities": {
          "description": {
            "urls": []
          }
        },
      "protected": false,
      "followers_count": 502084,
      "friends_count": 1472,
      "listed_count": 1514,
      "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": null,
      "profile_image_url": "null",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/880136122604507136/xHrnqf1T_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1498675817",
      "profile_link_color": "null",
      "profile_sidebar_border_color": "null",
      "profile_sidebar_fill_color": "null",
      "profile_text_color": "null",
      "profile_use_background_image": false,
      "has_extended_profile": null,
      "default_profile": false,
      "default_profile_image": false,
      "following": false,
      "follow_request_sent": false,
      "notifications": false,
      "translator_type": "null"
      }
    }  ]
}