GET users/suggestions/:slug (deprecated)

This endpoint will return a 410 Gone error after June 30, 2019 and should no longer be used. Please read our forum announcement for more details. 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": [

For more detail, see the user-object definition.