GET users/suggestions
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
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.
OAuth Signature Generator
Sign in to see a list of your registered applications.
Example Request
GET
https://api.twitter.com/1.1/users/suggestions.json
Example Result
[ { "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 } ]