Follow, search, and get users

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

Name Required Description Default Value Example
slug required The short name of list or a category   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.    

Example Request

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

Example Response

{
  "name": "Twitter",
  "slug": "twitter",
  "size": 20,
  "users": [
    {user-object},
    {user-object},
    {user-object}
  ]
}