v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Lists

Get list details

Get detailed information about a Twitter list. Returns comprehensive list details including name, description, member count, subscriber count, visibility mode, and owner information. Useful for understanding list composition before fetching its tweets.

get/v1/twitter/lists/{list_id}/detail

Path parameters

list_idstring required

Example:1580582120482430976

The unique numeric ID of the list.

Response

Successfully retrieved list details.

idstring required

Unique list identifier.

namestring required

Name of the list.

descriptionstring nullable

Description of the list.

created_atstring nullable

Timestamp when the list was created.

member_countinteger nullable

Number of members in the list.

subscriber_countinteger nullable

Number of subscribers to the list.

mode'public' | 'private' nullable

Visibility mode of the list.

user_idstring nullable

Numeric ID of the list owner.

usernamestring nullable

Username of the list owner.

Example response

{
  "id": "1580582120482430976",
  "name": "Tech Leaders"
}