GET lists/list
Returns all lists the authenticating or specified user subscribes to, including their own. The user is specified using the user_id or screen_name parameters. If no user is given, the authenticating user is used.
This method used to be GET lists in version 1.0 of the API and has been renamed for consistency with other call.
A maximum of 100 results will be returned by this call. Subscribed lists are returned first, followed by owned lists. This means that if a user subscribes to 90 lists and owns 20 lists, this method returns 90 subscriptions and 10 owned lists. The reverse method returns owned lists first, so with reverse=true, 20 owned lists and 80 subscriptions would be returned. If your goal is to obtain every list a user owns or subscribes to, use GET lists / ownerships and/or GET lists / subscriptions instead.
Resource URL
https://api.twitter.com/1.1/lists/list.jsonResource Information
Parameters
The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
Example Values: 12345
Note:: Specifies the ID of the user to get lists from. Helpful for disambiguating when a valid user ID is also a valid screen name.
The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.
Example Values: noradio
Set this to true if you would like owned lists to be returned first. See description above for information on how this parameter works.
Example Values: true
OAuth Signature Generator
Sign in to see a list of your registered applications.
Example Request
GET
https://api.twitter.com/1.1/lists/list.json?screen_name=twitterapiExample Result
[
{
"slug": "meetup-20100301",
"name": "meetup-20100301",
"created_at": "Sat Feb 27 21:39:24 +0000 2010",
"uri": "/twitterapi/meetup-20100301",
"subscriber_count": 147,
"id_str": "8044403",
"member_count": 116,
"mode": "public",
"id": 8044403,
"full_name": "@twitterapi/meetup-20100301",
"description": "Guests attending the Twitter meetup on 1 March 2010 at the @twoffice",
"user": {
"profile_background_tile": true,
"profile_sidebar_border_color": "C0DEED",
"name": "Twitter API",
"profile_sidebar_fill_color": "DDEEF6",
"location": "San Francisco, CA",
"created_at": "Wed May 23 06:01:13 +0000 2007",
"profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
"is_translator": false,
"id_str": "6253282",
"profile_link_color": "0084B4",
"follow_request_sent": false,
"favourites_count": 25,
"contributors_enabled": true,
"url": "http://dev.twitter.com",
"default_profile": false,
"profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
"utc_offset": -28800,
"profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302",
"id": 6253282,
"profile_use_background_image": true,
"listed_count": 11201,
"profile_text_color": "333333",
"protected": false,
"lang": "en",
"followers_count": 1444739,
"description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
"notifications": false,
"geo_enabled": true,
"verified": true,
"time_zone": "Pacific Time (US & Canada)",
"profile_background_color": "C0DEED",
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
"statuses_count": 3367,
"friends_count": 33,
"default_profile_image": false,
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
"following": true,
"screen_name": "twitterapi"
},
"following": false
},
{
"slug": "team",
"name": "team",
"created_at": "Wed Nov 04 01:24:28 +0000 2009",
"uri": "/twitterapi/team",
"subscriber_count": 277,
"id_str": "2031945",
"member_count": 20,
"mode": "public",
"id": 2031945,
"full_name": "@twitterapi/team",
"description": "",
"user": {
"profile_background_tile": true,
"profile_sidebar_border_color": "C0DEED",
"name": "Twitter API",
"profile_sidebar_fill_color": "DDEEF6",
"location": "San Francisco, CA",
"created_at": "Wed May 23 06:01:13 +0000 2007",
"profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
"is_translator": false,
"id_str": "6253282",
"profile_link_color": "0084B4",
"follow_request_sent": false,
"favourites_count": 25,
"contributors_enabled": true,
"url": "http://dev.twitter.com",
"default_profile": false,
"profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
"utc_offset": -28800,
"profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302",
"id": 6253282,
"profile_use_background_image": true,
"listed_count": 11201,
"profile_text_color": "333333",
"protected": false,
"lang": "en",
"followers_count": 1444739,
"description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
"notifications": false,
"geo_enabled": true,
"verified": true,
"time_zone": "Pacific Time (US & Canada)",
"profile_background_color": "C0DEED",
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
"statuses_count": 3367,
"friends_count": 33,
"default_profile_image": false,
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
"following": true,
"screen_name": "twitterapi"
},
"following": true
}
]