GET lists/members/show

API version 1.1
Updated on Thu, 2013-03-07 10:22

Check if the specified user is a member of the specified list.

Resource URL

https://api.twitter.com/1.1/lists/members/show.json

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.

list_id required

The numerical id of the list.

slug required

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.

user_id required

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.

screen_name required

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.

owner_screen_name optional

The screen name of the user who owns the list being requested by a slug.

owner_id optional

The user ID of the user who owns the list being requested by a slug.

include_entities optional

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.

skip_status optional

When set to either true, t or 1 statuses will not be included in the returned user objects.

Example Request

GET

https://api.twitter.com/1.1/lists/members/show.json?slug=team&owner_screen_name=twitter&screen_name=froginthevalley 

  1. {
  2.   "id": "657693",
  3.   "id_str": "657693",
  4.   "is_translator": false,
  5.   "default_profile": false,
  6.   "entities": {
  7.     "url": {
  8.       "urls": [
  9.         {
  10.           "url": "http://t.co/jtb0IaGT",
  11.           "indices": [
  12.             0,
  13.             20
  14.           ],
  15.           "display_url": "afroginthevalley.com",
  16.           "expanded_url": "http://afroginthevalley.com/"
  17.         }
  18.       ]
  19.     },
  20.     "description": {
  21.       "urls": []
  22.     }
  23.   },
  24.   "show_all_inline_media": false,
  25.   "profile_use_background_image": false,
  26.   "profile_text_color": "999999",
  27.   "utc_offset": -18000,
  28.   "listed_count": 302,
  29.   "name": "Sylvain Carle",
  30.   "notifications": false,
  31.   "profile_sidebar_border_color": "87CB00",
  32.   "geo_enabled": true,
  33.   "follow_request_sent": false,
  34.   "url": "http://t.co/jtb0IaGT",
  35.   "lang": "en",
  36.   "profile_image_url_https": "https://si0.twimg.com/profile_images/1532782858/sylvaincarle-2011-profile-480_normal.png",
  37.   "created_at": "Thu Jan 18 00:10:45 +0000 2007",
  38.   "protected": false,
  39.   "followers_count": 4281,
  40.   "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/228591248/bg-14.png",
  41.   "screen_name": "froginthevalley",
  42.   "profile_background_tile": true,
  43.   "friends_count": 2367,
  44.   "profile_sidebar_fill_color": "333333",
  45.   "description": "Developer Advocate at Twitter. Internet, opensource, media & geo/local geek. See also @sylvaincarle for LANG=FR.",
  46.   "time_zone": "Eastern Time (US & Canada)",
  47.   "default_profile_image": false,
  48.   "location": "San Francisco",
  49.   "profile_image_url": "http://a0.twimg.com/profile_images/1532782858/sylvaincarle-2011-profile-480_normal.png",
  50.   "favourites_count": 1790,
  51.   "following": false,
  52.   "profile_background_color": "000000",
  53.   "verified": false,
  54.   "statuses_count": 8191,
  55.   "status": {
  56.     "entities": {
  57.       "urls": [
  58.         {
  59.           "url": "http://t.co/GtBxX0IW",
  60.           "indices": [
  61.             54,
  62.             74
  63.           ],
  64.           "display_url": "example.com",
  65.           "expanded_url": "http://www.example.com"
  66.         },
  67.         {
  68.           "url": "http://t.co/2E5hDjME",
  69.           "indices": [
  70.             94,
  71.             114
  72.           ],
  73.           "display_url": "example.com",
  74.           "expanded_url": "http://example.com"
  75.         }
  76.       ],
  77.       "hashtags": [],
  78.       "user_mentions": [
  79.         {
  80.           "name": "VO5",
  81.           "indices": [
  82.             0,
  83.             6
  84.           ],
  85.           "screen_name": "MyVO5",
  86.           "id": "485879570",
  87.           "id_str": "485879570"
  88.         }
  89.       ]
  90.     },
  91.     "geo": null,
  92.     "place": null,
  93.     "in_reply_to_screen_name": "MyVO5",
  94.     "in_reply_to_user_id": 485879570,
  95.     "retweeted": false,
  96.     "in_reply_to_status_id": 243404113679888400,
  97.     "created_at": "Wed Sep 05 17:45:14 +0000 2012",
  98.     "possibly_sensitive": false,
  99.     "in_reply_to_status_id_str": "243404113679888385",
  100.     "contributors": null,
  101.     "favorited": false,
  102.     "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>",
  103.     "in_reply_to_user_id_str": "485879570",
  104.     "retweet_count": 0,
  105.     "id": "< Unable to parse in Javascript >",
  106.     "id_str": "243404435752099841",
  107.     "coordinates": null,
  108.     "truncated": false,
  109.     "text": "@MyVO5 make sure you configure your domain correctly, http://t.co/GtBxX0IW is not the same as http://t.co/2E5hDjME (also, refresh cache)."
  110.   },
  111.   "contributors_enabled": false,
  112.   "profile_background_image_url": "http://a0.twimg.com/profile_background_images/228591248/bg-14.png",
  113.   "profile_link_color": "009DFF"
  114. }