1

Today, we are launching the Lists lookup endpoints to the Twitter API v2. With the manage List earlier this fall, this release completes the List endpoint group for Twitter API v2, allowing developers to build solutions that enable people to curate and organize Tweets based on preferences, interests, groups, or topics as well as solutions that solve for analysis and discoverability use cases and needs.

In addition to the completion of the List endpoints, a new list: operator has been made available at the Academic Research access level. This will be available to use on search Tweets and Tweet counts.

Given the breadth of functionality offered by these endpoints, we’ve grouped them as follows:

List lookup

List lookup group has two available endpoints. You are able to retrieve details on a specified List by ID and user-owned Lists.

  • List lookup by ID - GET /2/lists/:id
    • Rate limit of 75 requests per 15 minutes
  • User-owned Lists - GET /2/users/:id/owned_lists
    • Rate limit of 15 requests per 15 minutes

List members

List members lookup group has two available endpoints. You are able to retrieve details on members of a specified List and see which Lists a user is a member of.

  • Members lookup - GET /2/lists/:id/members
    • Rate limit of 900 requests per 15 minutes
  • User memberships - GET /2/users/:id/list_memberships
    • Rate limit of 75 requests per 15 minutes

List follows

List follows lookup group has two available endpoints. You are able to retrieve details on followers of a specified List and which Lists a user follows.

  • Followers lookup - GET /2/lists/:id/followers
    • Rate limit of 180 requests per 15 minutes
  • User followed Lists - GET /2/users/:id/followed_lists
    • Rate limit of 15 requests per 15 minutes

Pinned Lists

Pinned List lookup has one available endpoint that allows you to retrieve an authenticated user’s pinned Lists.

  • Pinned List lookup - GET /2/users/:id/pinned_lists
    • Rate limit of 15 requests per 15 minutes

List Tweets lookup

List Tweets lookup has one available endpoint to retrieve Tweets from a specified List.

  • List Tweets lookup - GET /2/lists/:id/tweets
    • Rate limit of 900 requests per 15 minutes

Getting started

These List endpoints are available to all developers building with the Twitter API v2. Be sure to check out our documentation for more information on how to get started.

4 Likes