
Loading API details…
The Twitter API provides REST endpoints for reading and updating a user’s account settings, managing followers, friends, blocks, lists, and favorites, sending and retrieving direct messages, and querying geographic place information.
Latency p95
1930 ms
last successful checks
Uptime 30d
100.0%
monitored sample
Playground
Verified
live · allowlisted
Endpoints & operations
lists
(18)
/lists/members/destroy.json
Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list.
/lists/members.json
Returns the members of the specified list. Private list members will only be shown if the authenticated user owns the specified list.
/lists/members/create.json
Add a member to a list. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 500 members.
/lists/members/create_all.json
Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 500 members, and you are limited to adding up to 100 members to a list at a time with this method. Please note that there can be issues with lists that rapidly remove and add memberships. Take care when using these methods such that you are not too rapidly switching between removals and adds on the same list.
/lists/create.json
Creates a new list for the authenticated user. Note that you can't create more than 20 lists per account.
/lists/destroy.json
Deletes the specified list. The authenticated user must own the list to be able to destroy it.
/lists/list.json
Returns all lists the authenticating or specified user subscribes to, including their own. The user is specified using the user_id or screen_name parameters. If no user is given, the authenticating user is used. This method used to be GET lists in version 1.0 of the API and has been renamed for consistency with other call.
/lists/members/destroy_all.json
Removes multiple members from a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to remove members from it. Note that lists can't have more than 500 members, and you are limited to removing up to 100 members to a list at a time with this method. Please note that there can be issues with lists that rapidly remove and add memberships. Take care when using these methods such that you are not too rapidly switching between removals and adds on the same list.
/lists/members/show.json
Check if the specified user is a member of the specified list.
/lists/memberships.json
Returns the lists the specified user has been added to. If user_id or screen_name are not provided the memberships for the authenticating user are returned.
/lists/show.json
Returns the specified list. Private lists will only be shown if the authenticated user owns the specified list.
/lists/statuses.json
Returns tweet timeline for members of the specified list. Retweets are included by default. You can use the include_rts=false parameter to omit retweet objects.
/lists/subscribers.json
Returns the subscribers of the specified list. Private list subscribers will only be shown if the authenticated user owns the specified list.
/lists/subscribers/create.json
Subscribes the authenticated user to the specified list.
/lists/subscribers/destroy.json
Unsubscribes the authenticated user from the specified list.
/lists/subscribers/show.json
Check if the specified user is a subscriber of the specified list. Returns the user if they are subscriber.
/lists/subscriptions.json
Obtain a collection of the lists the specified user is subscribed to, 20 lists per page by default. Does not include the user's own lists.
/lists/update.json
Updates the specified list. The authenticated user must own the list to be able to update it.
account
(7)
application
(1)
blocks
(4)
direct_messages.json
(1)
direct_messages
(4)
favorites
(3)
followers
(1)
friends
(1)
friendships
(7)
geo
(5)
help
(4)
saved_searches
(4)
search
(1)
statuses
(10)
trends
(3)
users
(9)
⚠ Requires OAuth authentication — check the API’s own docs for the exact header/param to use.
curl -X POST \
"https://developer.twitter.com/en/docs/lists/members/destroy.json" \
-d '{}'developer.twitter.com · HTTPS only · OAuth auth