Comparing Twitter API’s Lists endpoints

The v2 manage Lists endpoints will eventually replace all of the v1.1 POST Lists endpoints, respectively. If you have code, apps, or tools that use an older version of these endpoints and are considering migrating to the newer Twitter API v2, then this guide is for you. 

These guides will focus on the following areas:

  • New JSON format - Twitter API v2 introduces a completely new JSON format. Any code that parses v1.1 standard, premium, and enterprise JSON payloads will need to be updated to work with the new formats.
  • App and Project requirements - To access the Twitter API v2, you will need to use credentials from a developer App that is associated with a Project

 

Manage Lists

The v2 manage List endpoints will replace the standard POST lists/create, POST lists/destroy, and POST lists/update endpoints.

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

 

Create 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/create.json /2/lists
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None 300 requests per 15 min (per user)

 

Delete 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/destroy.json /2/lists/:id
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None 300 requests per 15 min (per user)

 

Update a List

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

 

Manage List members

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

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

 

Add member

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/members/create.json /2/lists/:id/members
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None 300 requests per 15 min (per user)

 

Remove member

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/members/destroy.json /2/lists/:id/:user_id
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None 300 requests per 15 min (per user)

 

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)

 

Manage pinned Lists

The manage pinned List endpoints are new functionalities for v2, allowing you to pin and unpin Lists. 

 

Pin a List

Description Twitter API v2
HTTP methods supported POST
Host domain https://api.twitter.com
Endpoint path /2/users/:id/pinned_lists
Authentication OAuth 1.0a User Context
Default request rate limits 50 requests per 15 min (per user)

 

Unpin a List

Description Twitter API v2
HTTP methods supported DELETE
Host domain https://api.twitter.com
Endpoint path /2/users/:id/pinned_lists
Authentication OAuth 1.0a User Context
Default request rate limits 50 requests per 15 min (per user)

 

To access these endpoints, you must have an approved 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.

 

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.