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

Get list details

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/twitter/lists/{list_id}/detail \
  --header 'x-api-key: <api-key>'

200

{
  "id": "1580582120482430976",
  "name": "Tech Leaders",
  "description": "<string>",
  "created_at": "<string>",
  "member_count": 123,
  "subscriber_count": 123,
  "user_id": "<string>",
  "username": "<string>"
}

Authorizations

x-api-key · string · header · required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Path Parameters

list_id · string · required

The unique numeric ID of the list.

Example:

"1580582120482430976"

Response

200

application/json

Successfully retrieved list details.

Twitter list metadata.

id · string · required

Unique list identifier.

Example:

"1580582120482430976"

name · string · required

Name of the list.

Example:

"Tech Leaders"

description · string | null

Description of the list.

created_at · string | null

Timestamp when the list was created.

member_count · integer | null

Number of members in the list.

subscriber_count · integer | null

Number of subscribers to the list.

mode · enum<string> | null

Visibility mode of the list.

Available options: public, private

user_id · string | null

Numeric ID of the list owner.

username · string | null

Username of the list owner.