Create and manage lists
API Reference contents
GET lists/list
GET lists/members
GET lists/members/show
GET lists/memberships
GET lists/ownerships
GET lists/show
GET lists/statuses
GET lists/subscribers
GET lists/subscribers/show
GET lists/subscriptions
POST lists/create
POST lists/destroy
POST lists/members/create
POST lists/members/create_all
POST lists/members/destroy
POST lists/members/destroy_all
POST lists/subscribers/create
POST lists/subscribers/destroy
POST lists/update
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"
}
} ]
}