Comparing Twitter API’s List follows endpoints

The v2 List follows endpoint group will replace the standard v1.1 GET lists/subscribersGET lists/subscriptionsPOST lists/subscribers/create, and POST lists/subscribers/destroy endpoints. If you have code, apps, or tools that use one of these versions of the List follows endpoints, and are considering migrating to the newer Twitter API v2 endpoint, then this set of guides is for you.

 

List follows lookup

The v2 List follows lookup endpoint group will replace the standard GET lists/subscribersGET lists/subscriptions endpoints.

The following tables compare the standard v1.1 and Twitter API v2 List endpoints:

 

List follower Lookup

Description

Standard v1.1

Twitter API v2

HTTP methods supported

GET

GET

Host domain

https://api.twitter.com

https://api.twitter.com

Endpoint path

/1.1/lists/subscribers.json

/2/lists/:id/followers

Authentication

OAuth 1.0a User Context

OAuth 2.0 Bearer Token

OAuth 1.0a User Context

OAuth 2.0 Bearer Token

Default request rate limits

180 requests per 15 min with OAuth 1.0a

15 requests per 15min with OAuth 2.0 Bearer Token

180 requests per 15 min with OAuth 1.0a

180 requests per 15 min with OAuth 2.0 Bearer Token

 

User's followed List lookup

Description

Standard v1.1

Twitter API v2

HTTP methods supported

GET

GET

Host domain

https://api.twitter.com

https://api.twitter.com

Endpoint path

/1.1/lists/subscriptions.json

/2/users/:id/followed_lists

Authentication

OAuth 1.0a User Context

OAuth 2.0 Bearer Token

OAuth 1.0a User Context

OAuth 2.0 Bearer Token

Default request rate limits

15 requests per 15 min with OAuth 1.0a

15 requests per 15min with OAuth 2.0 Bearer Token

15 requests per 15 min with OAuth 1.0a

15 requests per 15min with OAuth 2.0 Bearer Token


Manage List follows

The v2 manage List follows endpoint group will replace the standard POST lists/subscribers/create, POST lists/subscribers/destroy endpoints.

The following tables compare the standard v1.1 and Twitter API v2 List endpoints:

 

Follow a List

Description Standard v1.1 Twitter API v2
HTTP methods supported POST POST
Host domain https://api.twitter.com https://api.twitter.com
Endpoint path /1.1/lists/subscribers/create.json /2/users/:id/followed_lists
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None 50 requests per 15 min (per user)

 

Unfollow a List

Description Standard v1.1 Twitter API v2
HTTP methods supported POST DELETE
Host domain https://api.twitter.com https://api.twitter.com
Endpoint path /1.1/lists/subscribers/destroy.json /2/users/:id/followed_lists/:list_id
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None 50 requests per 15 min (per user)

 

To access the Twitter API v2 endpoints, you must sign up for a developer account. When authenticating, you must use keys and tokens from a developer App that is located within a Project

Learn more about getting access to the Twitter API v2 endpoints in our getting started page.