Follow, search, and get users

Please note

We've released the following endpoints within the Twitter API v2 . 

v1.1 endpoints Corresponding v2 endpoints  

GET users/lookup
GET users/show

User lookup Migration guide

GET followers/ids
GET followers/list
GET friends/ids
GET friends/list
POST friendships/create
POST friendships/destroy

Follows Migration guide

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

 

Overview

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.
 

Terminology

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.