Overview

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.