Manage Lists contains the Twitter API v2 versions of the following standard v1.1 endpoints:

 

To see what's new with these v2 endpoints, please visit our comparison guide.

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

Introduction

Twitter Lists allows users to customize, organize and prioritize the Tweets they see in their timeline. With the Lists endpoints, you can build solutions that enable people  to curate and organize Tweets based on preferences, interests, groups, or topics.

 

Since you are making requests on behalf of a user with all managed List endpoints, you must authenticate with OAuth 1.0a User Context and use the Access Tokens associated with a user that has authorized your App.  You can generate Access Tokens using the 3-legged OAuth flow.

 

Manage Lists

The manage List endpoints allow you to create, delete, and update Lists on behalf of an authenticated user. For these endpoints, there are three methods available: POST, DELETE and PUT. The POST method allows you to create a List, the DELETE method allows you to delete a List, and the PUT method allows you to update the metadata of a List. There is a user rate limit of 300 requests per 15 minutes for all three endpoints.

Note that you can create up to 1000 Lists per account.

 

Manage List members

The manage List members endpoints allow you to add and remove members to a List on behalf of an authenticated user. For these endpoints, there are two methods available: POST and DELETE. The POST method allows you to add a member to a List, and the DELETE method allows you to remove a member from a List. There is a user rate limit of 300 requests per 15 minutes for both endpoints.

Note that Lists cannot have more than 5,000 members.

 

Manage List follows

The manage List follows endpoints allow you to follow and unfollow a List on behalf of an authenticated user. For these endpoints, there are two methods available: POST and DELETE. The POST method allows you to follow a List, and the DELETE method allows you to delete a List. There is a user rate limit of 50 requests per 15 minutes for both endpoints.

 

Manage pinned Lists

The manage pinned List endpoints allow you to pin and unpin a List on behalf of an authenticated user. For these endpoints, there are two methods available: POST and DELETE. The POST method allows you to pin a List, and the DELETE method allows you to unpin a List. There is a user rate limit of 50 requests per 15 minutes for both endpoints.

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.