Follow, search, and get users
API Reference contents
GET followers/ids
GET followers/list
GET friends/ids
GET friends/list
GET friendships/incoming
GET friendships/lookup
GET friendships/no_retweets/ids
GET friendships/outgoing
GET friendships/show
GET users/lookup
GET users/search
GET users/show
GET users/suggestions
GET users/suggestions/:slug
GET users/suggestions/:slug/members
POST friendships/create
POST friendships/destroy
POST friendships/update
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 | ||
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}
]
}