The endpoints described in this section are the replacements of v1.1 followers/ids, v1.1 followers/list, v1.1 friends/ids, and v1.1 friends/list . If you are currently using any of these endpoints, you can use our migration materials to start working with this new endpoint. 

Learn more about the new Twitter API v2: Early Access.


Following users is one of the most foundational actions on Twitter; users can keep up to date with their relevant connections by following other users on Twitter. At a larger scale, this creates a network of connections between users.

The follows lookup endpoints enable you to explore and analyze the relationships between users, which is sometimes called network analysis. Specifically, there are two RESTful endpoints that return user objects representing who a specified user is following, or who is following a specified user. 

You can authenticate these endpoints with either OAuth 1.0a User Context or OAuth 2.0 Bearer Token. Also, you can request up to 1000 users per request, and pagination tokens will be provided for paging through large sets of matching Tweets. 

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.