Follow, search, and get users

The following API endpoints can be used to programmatically follow users, search for users, and get user information:

Friends and followers POST friendships Get user info
  • 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
  • POST friendships/create
  • POST friendships/destroy
  • POST friendships/update
  • GET users/lookup
  • GET users/search
  • GET users/show
  • GET users/suggestions
  • GET users/suggestions/:slug
  • GET users/suggestions/:slug/members

For more details, please see the individual endpoint information within the API reference section.


To avoid confusion around the term "friends" and "followers" with respect to the API endpoints, below is a definition of each:

Friends - we refer to "friends" as the Twitter users that a specific user follows (e.g., following). Therefore, the GET friends/ids endpoint returns a collection of user IDs that the specified user follows.

Followers - refers to the Twitter users that follow a specific user. Therefore, making a request to the GET followers/ids endpoint returns a collection of user IDs for every user following the specified user.