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

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


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


Example Response

  "name": "Twitter",
  "slug": "twitter",
  "size": 20,
  "users": [