Follow, search, and get users

Please note:

We launched a new version of the following endpoints as part of Twitter API v2: Early Access:

v1.1 endpoints v2 replacement endpoints  

users/lookup and users/show

User lookup Migration guide

followers/idsfollowers/listfriends/ids, and friends/list

Follows lookup Migration guide

If you are currently using any of these endpoints, you can use our migration materials to start working with the newer endpoint.



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

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.


Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.