GET users/suggestions/:slug/members

Access the users in a given category of the Twitter suggested user list and return their most recent status if they are not a protected user.

Resource URL

https://api.twitter.com/1.1/users/suggestions/:slug/members.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
slug required The short name of list or a category   twitter

Example Request

GET https://api.twitter.com/1.1/users/suggestions/funny/members.json

Example Response

[
  {
    "id": 23083404,
    "id_str": "23083404",
    "name": "LeBron James",
    "screen_name": "KingJames",
    "location": "Amongst La Familia! ",
    "description": "EST. AKRON - ST.V/M Class of '03  http://t.co/IneJylUd1m #IPROMISE",
    "url": "http://t.co/TuET0GeB2Z",
    "entities": {
      "url": {
        "urls": [
          {
            "url": "http://t.co/TuET0GeB2Z",
            "expanded_url": "http://LeBronJames.com",
            "display_url": "LeBronJames.com",
            "indices": [
              0,
              22
            ]
          }
        ]
      },
      "description": {
        "urls": [
          {
            "url": "http://t.co/IneJylUd1m",
            "expanded_url": "http://LeBronJamesFamilyFoundation.org",
            "display_url": "LeBronJamesFamilyFoundation.org",
            "indices": [
              34,
              56
            ]
          }
        ]
      }
    },
    "protected": false,
    "followers_count": 40721832,
    "friends_count": 180,
    "listed_count": 43037,
    "created_at": "Fri Mar 06 16:25:53 +0000 2009",
    "favourites_count": 113,
    "utc_offset": -18000,
    "time_zone": "Quito",
    "geo_enabled": false,
    "verified": true,
    "statuses_count": 5743,
    "lang": "en",
    "status": {
      "created_at": "Tue Feb 20 02:30:08 +0000 2018",
      "id": 965775548067676200,
      "id_str": "965775548067676160",
      "text": "@AntDavis23 @verizon 💯we’ll be playing an ASG like this one day. Sheesh!! 😎 https://t.co/0FOjSmkJ9h",
      "truncated": false,
      "entities": {
        "hashtags": [

        ],
        "symbols": [

        ],
        "user_mentions": [
          {
            "screen_name": "AntDavis23",
            "name": "Anthony Davis",
            "id": 159113258,
            "id_str": "159113258",
            "indices": [
              0,
              11
            ]
          },
          {
            "screen_name": "verizon",
            "name": "Verizon",
            "id": 59889953,
            "id_str": "59889953",
            "indices": [
              12,
              20
            ]
          }
        ],
        "urls": [

        ],
        "media": [
          {
            "id": 965775542652878800,
            "id_str": "965775542652878849",
            "indices": [
              76,
              99
            ],
            "media_url": "http://pbs.twimg.com/media/DWcfvTiVwAE7lDe.jpg",
            "media_url_https": "https://pbs.twimg.com/media/DWcfvTiVwAE7lDe.jpg",
            "url": "https://t.co/0FOjSmkJ9h",
            "display_url": "pic.twitter.com/0FOjSmkJ9h",
            "expanded_url": "https://twitter.com/KingJames/status/965775548067676160/photo/1",
            "type": "photo",
            "sizes": {
              "small": {
                "w": 453,
                "h": 680,
                "resize": "fit"
              },
              "medium": {
                "w": 799,
                "h": 1200,
                "resize": "fit"
              },
              "large": {
                "w": 1364,
                "h": 2048,
                "resize": "fit"
              },
              "thumb": {
                "w": 150,
                "h": 150,
                "resize": "crop"
              }
            }
          }
        ]
      },
      "extended_entities": {
        "media": [
          {
            "id": 965775542652878800,
            "id_str": "965775542652878849",
            "indices": [
              76,
              99
            ],
            "media_url": "http://pbs.twimg.com/media/DWcfvTiVwAE7lDe.jpg",
            "media_url_https": "https://pbs.twimg.com/media/DWcfvTiVwAE7lDe.jpg",
            "url": "https://t.co/0FOjSmkJ9h",
            "display_url": "pic.twitter.com/0FOjSmkJ9h",
            "expanded_url": "https://twitter.com/KingJames/status/965775548067676160/photo/1",
            "type": "photo",
            "sizes": {
              "small": {
                "w": 453,
                "h": 680,
                "resize": "fit"
              },
              "medium": {
                "w": 799,
                "h": 1200,
                "resize": "fit"
              },
              "large": {
                "w": 1364,
                "h": 2048,
                "resize": "fit"
              },
              "thumb": {
                "w": 150,
                "h": 150,
                "resize": "crop"
              }
            }
          }
        ]
      },
      "source": "<a href="http://twitter.com/download/iphone" rel="nofollow">Twitter for iPhone</a>",
      "in_reply_to_status_id": 965773924804915200,
      "in_reply_to_status_id_str": "965773924804915201",
      "in_reply_to_user_id": 159113258,
      "in_reply_to_user_id_str": "159113258",
      "in_reply_to_screen_name": "AntDavis23",
      "geo": null,
      "coordinates": null,
      "place": null,
      "contributors": null,
      "is_quote_status": false,
      "retweet_count": 628,
      "favorite_count": 7431,
      "favorited": false,
      "retweeted": false,
      "possibly_sensitive": false,
      "lang": "en"
    },
    "contributors_enabled": false,
    "is_translator": false,
    "is_translation_enabled": true,
    "profile_background_color": "000000",
    "profile_background_image_url": "http://pbs.twimg.com/profile_background_images/378800000104492008/d11e7b1d2751298ff3f81494ad045d9d.jpeg",
    "profile_background_image_url_https": "https://pbs.twimg.com/profile_background_images/378800000104492008/d11e7b1d2751298ff3f81494ad045d9d.jpeg",
    "profile_background_tile": false,
    "profile_image_url": "http://pbs.twimg.com/profile_images/748603714705952768/-8HcqbKS_normal.jpg",
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/748603714705952768/-8HcqbKS_normal.jpg",
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/23083404/1467315994",
    "profile_link_color": "FBAF41",
    "profile_sidebar_border_color": "000000",
    "profile_sidebar_fill_color": "DDEEF6",
    "profile_text_color": "333333",
    "profile_use_background_image": true,
    "has_extended_profile": false,
    "default_profile": false,
    "default_profile_image": false,
    "following": false,
    "follow_request_sent": false,
    "notifications": false,
    "translator_type": "none"
  }
]