Follow, search, and get users

Please note

We've recently released the following endpoints within the Twitter API v2 . The new version is currently in development and serves adequate access for the majority of developers on our platform. While elevated levels of access are coming to v2 soon, developers in need of higher levels of access either continue using the v1.1 versions or explore our v1.1 premium or enterprise APIs to see if one of those products will work with your use case. 

v1.1 endpoints Corresponding v2 endpoints  

GET users/lookup
GET users/show

User lookup Comparison guide

GET followers/ids
GET followers/list
GET friends/ids
GET friends/list

Follows lookup Comparison guide
POST friendships/create
POST friendships/destroy
Manage follows Comparison guide

Please use the comparison guides to see what has changed between the standard v1.1 and v2 versions.



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.