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