Comparing X 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 X 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 X API v2 List endpoints:
List member Lookup
Description |
Standard v1.1 |
X 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 |
X 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 X API v2 List endpoints:
Add member
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | POST |
| Host domain | https://api.x.com | https://api.x.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 | X API v2 |
|---|---|---|
| HTTP methods supported | POST | DELETE |
| Host domain | https://api.x.com | https://api.x.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 X 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 X API v2 endpoints in our getting started page.
