GET users/suggestions/:slug

Access the users in a given category of the Twitter suggested user list.

It is recommended that applications cache this data for no more than one hour.

Resource URL

https://api.twitter.com/1.1/users/suggestions/:slug.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

slug required

The short name of list or a category

Example Values: twitter

lang optional

Restricts the suggested categories to the requested language. The language must be specified by the appropriate two letter ISO 639-1 representation. Currently supported languages are provided by the GET help / languages API request. Unsupported language codes will receive English (en) results. If you use lang in this request, ensure you also include it when requesting the GET users / suggestions / :slug list.

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

GET

https://api.twitter.com/1.1/users/suggestions/twitter.json

Example Result

{
  "name": "Twitter",
  "slug": "twitter",
  "size": 20,
  "users": [
    {
      "name": "Twitter Sverige",
      "profile_sidebar_border_color": "C0DEED",
      "profile_sidebar_fill_color": "DDEEF6",
      "profile_background_tile": false,
      "created_at": "Mon Oct 31 23:10:57 +0000 2011",
      "profile_image_url": "http://a0.twimg.com/profile_images/2284174853/63g4ld4sm6yh4sssy7wy_normal.png",
      "location": "Sweden",
      "profile_link_color": "0084B4",
      "follow_request_sent": false,
      "is_translator": false,
      "id_str": "402357141",
      "default_profile": true,
      "url": "https://twitter.com/about/translation",
      "favourites_count": 0,
      "contributors_enabled": true,
      "utc_offset": 3600,
      "id": 402357141,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174853/63g4ld4sm6yh4sssy7wy_normal.png",
      "listed_count": 43,
      "profile_use_background_image": true,
      "profile_text_color": "333333",
      "protected": false,
      "lang": "sv",
      "followers_count": 55446,
      "geo_enabled": false,
      "time_zone": "Stockholm",
      "notifications": false,
      "verified": false,
      "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png",
      "profile_background_color": "C0DEED",
      "description": "Community-konto för Twitter i Sverige. Vi håller er uppdaterade kring vad som händer på Twitter i Sverige.",
      "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png",
      "friends_count": 260,
      "statuses_count": 62,
      "default_profile_image": false,
      "show_all_inline_media": false,
      "screen_name": "twitter_se",
      "following": false
    },
    {
      "name": "Twitter Suomi",
      "profile_sidebar_border_color": "C0DEED",
      "profile_sidebar_fill_color": "DDEEF6",
      "profile_background_tile": false,
      "created_at": "Mon Oct 31 23:05:34 +0000 2011",
      "profile_image_url": "http://a0.twimg.com/profile_images/2284174783/cwp44h4tg1mkl90cta0p_normal.png",
      "location": "Finland",
      "profile_link_color": "0084B4",
      "follow_request_sent": false,
      "is_translator": false,
      "id_str": "402354593",
      "default_profile": true,
      "url": "https://twitter.com/about/translation",
      "favourites_count": 5,
      "contributors_enabled": true,
      "utc_offset": 7200,
      "id": 402354593,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174783/cwp44h4tg1mkl90cta0p_normal.png",
      "listed_count": 49,
      "profile_use_background_image": true,
      "profile_text_color": "333333",
      "protected": false,
      "lang": "fi",
      "followers_count": 64440,
      "geo_enabled": false,
      "time_zone": "Helsinki",
      "notifications": false,
      "verified": false,
      "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png",
      "profile_background_color": "C0DEED",
      "description": "Twitterin suomalainen yhteisötili. Ylläpitäjinä käännösmoderaattorit @Zedinc, @SuihinOkko, @Delzun ja @DiamonDie.",
      "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png",
      "friends_count": 31,
      "statuses_count": 83,
      "default_profile_image": false,
      "show_all_inline_media": false,
      "screen_name": "twitter_fi",
      "following": false
    },
    {
      "name": "Twitter Government",
      "profile_sidebar_border_color": "C0DEED",
      "profile_sidebar_fill_color": "DDEEF6",
      "profile_background_tile": false,
      "created_at": "Sat Dec 04 23:27:01 +0000 2010",
      "profile_image_url": "http://a0.twimg.com/profile_images/2284291316/xu1u3i11ugj03en53ujr_normal.png",
      "location": "Washington, DC",
      "profile_link_color": "0084B4",
      "follow_request_sent": false,
      "is_translator": false,
      "id_str": "222953824",
      "default_profile": false,
      "url": "http://twitter.com",
      "favourites_count": 6,
      "contributors_enabled": true,
      "utc_offset": -18000,
      "id": 222953824,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/2284291316/xu1u3i11ugj03en53ujr_normal.png",
      "listed_count": 888,
      "profile_use_background_image": true,
      "profile_text_color": "333333",
      "protected": false,
      "lang": "en",
      "followers_count": 149418,
      "geo_enabled": true,
      "time_zone": "Eastern Time (US & Canada)",
      "notifications": false,
      "verified": true,
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/378138859/townhallbg.jpg",
      "profile_background_color": "C0DEED",
      "description": "Updates from the Twitter Government & Politics team, tracking creative & effective uses of Twitter for civic engagement. RTs & examples≠political endorsements.",
      "profile_background_image_url": "http://a0.twimg.com/profile_background_images/378138859/townhallbg.jpg",
      "friends_count": 0,
      "statuses_count": 338,
      "default_profile_image": false,
      "show_all_inline_media": false,
      "screen_name": "gov",
      "following": true
    }
  ]
}