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

[
  {
    "name": "Total Frat Move",
    "profile_sidebar_fill_color": "DDEEF6",
    "profile_background_tile": true,
    "profile_sidebar_border_color": "C0DEED",
    "profile_image_url": "http://a0.twimg.com/profile_images/1678357868/tfm-social-icon_normal.png",
    "location": "",
    "created_at": "Sat May 15 11:28:50 +0000 2010",
    "follow_request_sent": false,
    "id_str": "144130505",
    "profile_link_color": "0084B4",
    "is_translator": false,
    "default_profile": false,
    "favourites_count": 2,
    "contributors_enabled": false,
    "url": "http://totalfratmove.com",
    "profile_image_url_https": "https://si0.twimg.com/profile_images/1678357868/tfm-social-icon_normal.png",
    "utc_offset": -21600,
    "id": 144130505,
    "profile_use_background_image": true,
    "listed_count": 1167,
    "profile_text_color": "333333",
    "lang": "en",
    "followers_count": 459357,
    "protected": false,
    "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/157156573/sailboat-background-02.png",
    "geo_enabled": false,
    "description": "",
    "profile_background_color": "F2E8BA",
    "verified": true,
    "notifications": false,
    "time_zone": "Central Time (US & Canada)",
    "statuses_count": 7065,
    "status": {
      "coordinates": null,
      "created_at": "Fri Aug 24 19:05:26 +0000 2012",
      "favorited": false,
      "truncated": false,
      "id_str": "239075966431932418",
      "retweeted_status": {
        "coordinates": null,
        "created_at": "Fri Aug 24 19:05:06 +0000 2012",
        "favorited": false,
        "truncated": false,
        "id_str": "239075883053367297",
        "in_reply_to_user_id_str": null,
        "text": "You don't want to miss this week's Fail Friday. It includes a picture of a Pike in a porno: http://t.co/TypZqAe6",
        "contributors": null,
        "retweet_count": 15,
        "id": 239075883053367297,
        "in_reply_to_status_id_str": null,
        "geo": null,
        "retweeted": false,
        "possibly_sensitive": false,
        "in_reply_to_user_id": null,
        "place": null,
        "source": "HootSuite",
        "in_reply_to_screen_name": null,
        "possibly_sensitive_editable": true,
        "in_reply_to_status_id": null
      },
      "in_reply_to_user_id_str": null,
      "text": "RT @TFMintern: You don't want to miss this week's Fail Friday. It includes a picture of a Pike in a porno: http://t.co/TypZqAe6",
      "contributors": null,
      "retweet_count": 15,
      "id": 239075966431932418,
      "in_reply_to_status_id_str": null,
      "geo": null,
      "retweeted": false,
      "possibly_sensitive": false,
      "in_reply_to_user_id": null,
      "place": null,
      "source": "HootSuite",
      "in_reply_to_screen_name": null,
      "possibly_sensitive_editable": true,
      "in_reply_to_status_id": null
    },
    "profile_background_image_url": "http://a0.twimg.com/profile_background_images/157156573/sailboat-background-02.png",
    "default_profile_image": false,
    "friends_count": 1670,
    "screen_name": "totalfratmove",
    "following": false,
    "show_all_inline_media": true
  }
]