GET lists/subscribers/show
Check if the specified user is a subscriber of the specified list. Returns the user if they are subscriber.
Resource URL
https://api.twitter.com/1.1/lists/subscribers/show.json
Resource Information
Parameters
Either a list_id
or a slug
is required. If providing a list_slug
, an owner_screen_name
or owner_id
is also required.
The screen name of the user who owns the list being requested by a slug
.
The user ID of the user who owns the list being requested by a slug
.
The numerical id
of the list.
You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you’ll also have to specify the list owner using the owner_id
or owner_screen_name
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.
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.
When set to either true
, t
or 1
, each tweet will include a node called “entities”. This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more details.
When set to either true
, t
or 1
statuses will not be included in the returned user objects.
OAuth Signature Generator
Sign in to see a list of your registered applications.
Example Request
GET
https://api.twitter.com/1.1/lists/subscribers/show.json?slug=team&owner_screen_name=twitter&screen_name=episod
Example Result
{ "id": "819797", "id_str": "819797", "is_translator": false, "default_profile": false, "entities": { "url": { "urls": [ { "url": "http://t.co/Lxw7upbN", "indices": [ 0, 20 ], "display_url": "rebelmouse.com/episod/", "expanded_url": "http://www.rebelmouse.com/episod/" } ] }, "description": { "urls": [] } }, "show_all_inline_media": true, "profile_use_background_image": true, "profile_text_color": "D20909", "utc_offset": -28800, "listed_count": 341, "name": "Taylor Singletary", "notifications": false, "profile_sidebar_border_color": "000000", "geo_enabled": true, "follow_request_sent": false, "url": "http://t.co/Lxw7upbN", "lang": "en", "profile_image_url_https": "https://si0.twimg.com/profile_images/2574556418/dk93ji5e3w4rwscaabt3_normal.png", "created_at": "Wed Mar 07 22:23:19 +0000 2007", "protected": false, "followers_count": 7180, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "screen_name": "episod", "profile_background_tile": true, "friends_count": 5452, "profile_sidebar_fill_color": "FBFBFB", "description": "Reality Technician, Twitter API team, synthesizer enthusiast; a most excellent adventure in timelines. Missive commander.", "time_zone": "Pacific Time (US & Canada)", "default_profile_image": false, "location": "San Francisco, CA", "profile_image_url": "http://a0.twimg.com/profile_images/2574556418/dk93ji5e3w4rwscaabt3_normal.png", "profile_banner_url": "https://si0.twimg.com/profile_banners/819797/1346803502", "favourites_count": 16076, "following": true, "profile_background_color": "000000", "verified": false, "statuses_count": 18132, "status": { "entities": { "urls": [ { "url": "http://t.co/4mdAn0tF", "indices": [ 16, 36 ], "display_url": "youtube.com/watch?v=pPkNtg…", "expanded_url": "http://www.youtube.com/watch?v=pPkNtg3Fvwk&feature=youtube_gdata_player" } ], "hashtags": [], "user_mentions": [] }, "geo": null, "place": null, "in_reply_to_screen_name": null, "in_reply_to_user_id": null, "retweeted": false, "in_reply_to_status_id": null, "created_at": "Wed Sep 05 15:57:09 +0000 2012", "possibly_sensitive": false, "in_reply_to_status_id_str": null, "contributors": null, "favorited": false, "source": "YouTube on iOS", "in_reply_to_user_id_str": null, "retweet_count": 0, "id": "< Unable to parse in Javascript >", "id_str": "243377236902821888", "coordinates": null, "truncated": false, "text": "Current status http://t.co/4mdAn0tF" }, "contributors_enabled": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "profile_link_color": "C71818" }