Introduction

List follows lookup

List follows lookup group has two available endpoints. You are able to retrieve details on followers of a specified List and get data on which Lists a user follows. These endpoints can be used to enable people to curate and organize Tweets based on what type of Lists other users are following.

There is a rate limit of 180 requests per 15 minutes when looking up followers of a List and a limit of 15 requests per 15 minutes when looking up what Lists a user follows.

You can use OAuth 1.0a User ContextOAuth 2.0 App-Only, or OAuth 2.0 Authorization Code with PKCE to authenticate your requests to this endpoint. 
 

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.

Since you are making requests on behalf of a user with these endpoints, you must authenticate them with either OAuth 1.0a User Context or OAuth 2.0 Authorization Code with PKCE, and use the user Access Tokens associated with a user that has authorized your App, which can be generated using the 3-legged OAuth flow (OAuth 1.0a) or the Authorization Code with PKCE grant flow (OAuth 2.0).

Account setup

To access these endpoints, you will need:

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