Skip to Main Content Area

GET lists/subscribers/show

API version 1.1

Updated on Thu, 2013-03-07 10:28

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

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.

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.

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.

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/subscribers/show.json?slug=team&owner_screen_name=twitter&screen_name=episod`

```
{
```
```
  "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": "<a href=\"http://www.apple.com\" rel=\"nofollow\">YouTube on iOS</a>",

```
    "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"
```
```
}
```