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

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}
  ]
}

For more detail, see the user-object definition.