Follow, search, and get users
GET users/suggestions (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 to Twitter's suggested user list. This returns the list of suggested user categories. The category can be used in GET users / suggestions / :slug to get the users in that category.
Resource URL¶
https://api.twitter.com/1.1/users/suggestions.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 |
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.json
Example Response¶
[
{
"name": "Art & Design",
"slug": "art-design",
"size": 20
},
{
"name": "Billboard Music Awards",
"slug": "billboard-music-awards",
"size": 20
},
{
"name": "Books",
"slug": "books",
"size": 20
},
{
"name": "Business",
"slug": "business",
"size": 20
},
{
"name": "CMT Awards",
"slug": "cmt-awards",
"size": 20
},
{
"name": "Charity",
"slug": "charity",
"size": 20
},
{
"name": "Entertainment",
"slug": "entertainment",
"size": 20
},
{
"name": "Faith and Religion",
"slug": "faith-and-religion",
"size": 20
},
{
"name": "Family",
"slug": "family",
"size": 20
},
{
"name": "Fashion",
"slug": "fashion",
"size": 20
},
{
"name": "Food & Drink",
"slug": "food-drink",
"size": 20
},
{
"name": "Funny",
"slug": "funny",
"size": 20
},
{
"name": "Government",
"slug": "government",
"size": 20
},
{
"name": "Health",
"slug": "health",
"size": 20
},
{
"name": "MLB",
"slug": "mlb",
"size": 20
},
{
"name": "MTV Movie Awards",
"slug": "mtv-movie-awards",
"size": 20
},
{
"name": "Music",
"slug": "music",
"size": 20
},
{
"name": "NASCAR",
"slug": "nascar",
"size": 20
},
{
"name": "NBA",
"slug": "nba",
"size": 20
},
{
"name": "NHL",
"slug": "nhl",
"size": 20
},
{
"name": "News",
"slug": "news",
"size": 20
},
{
"name": "PGA",
"slug": "pga",
"size": 20
},
{
"name": "Science",
"slug": "science",
"size": 20
},
{
"name": "Sports",
"slug": "sports",
"size": 20
},
{
"name": "Staff Picks",
"slug": "staff-picks",
"size": 20
},
{
"name": "Technology",
"slug": "technology",
"size": 20
},
{
"name": "Television",
"slug": "television",
"size": 20
},
{
"name": "Travel",
"slug": "travel",
"size": 20
},
{
"name": "Twitter",
"slug": "twitter",
"size": 20
},
{
"name": "US Election 2012",
"slug": "us-election-2012",
"size": 20
}
]