v6

latestOpenAPI 3.0.0raw.githubusercontent.com2025-03-123918105.6 KB
Data API

Get User's Lists

Returns array of lists a user created or is subscribed to. Typically Twitter returns up to 100 lists per page. You can request additional results by sending another request to the same endpoint using cursor parameter.

get/twitter/user/{user_id}/lists

Path parameters

user_idstring required

The numeric ID of the desired user. When using languages where the user_id value exceeds the default Integer type limit (e.g., JavaScript), you should store user_id as a String. Use the id_str property returned by the API for these values.

Query parameters

cursorstring

Cursor value obtained from next_cursor response property. Use this parameter to retrieve additional pages. Omit this parameter to retrieve the first page. Cursor may contain spaces and other special characters, therefore always remember to URL-encode the value.

Response

Request succeeded

next_cursorstring required

Cursor for pagination to get the next page of results

listsobject[] required