Comparing Twitter API’s List members endpoints
The v2 List members endpoint group will replace the standard v1.1 GET lists/members, GET lists/memberships, POST lists/members/create and POST lists/members/destroy endpoints. If you have code, apps, or tools that use one of these versions of the List member endpoints, and are considering migrating to the newer Twitter API v2 endpoint, then this set of guides is for you.
List members lookup
The v2 List members lookup endpoints will replace the standard GET lists/members, GET lists/memberships, endpoints.
The following tables compare the standard v1.1 and Twitter API v2 List endpoints:
List member Lookup
Description |
Standard v1.1 |
Twitter API v2 |
HTTP methods supported |
|
|
Host domain |
|
|
Endpoint path |
|
|
OAuth 1.0a User Context App only |
OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE App only |
|
Default request rate limits |
900 requests per 15 min with OAuth 1.0a 75 requests per 15min with App only |
900 requests per 15 min with OAuth 1.0a 900 requests per 15 min with OAuth 2.0 900 requests per 15 min with App only |
List membership lookup
Description |
Standard v1.1 |
Twitter API v2 |
HTTP methods supported |
|
|
Host domain |
|
|
Endpoint path |
|
|
OAuth 1.0a User Context App only |
OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE App only |
|
Default request rate limits |
75 requests per 15 min with OAuth 1.0a 75 requests per 15min with App only |
75 requests per 15 min with OAuth 1.0a 75 requests per 15 min with OAuth 2.0 75 requests per 15min with App only |
Manage List members
The v2 manage List members endpoints 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 OAuth 2.0 Authorization Code with PKCE |
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 OAuth 2.0 Authorization Code with PKCE |
Default request rate limits | None | 300 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.