X List Members

GET/v1/x/lists/{id}/members

MCPx_list_members3 creditsLive

Updated Oct 14, 2026

Description

List everyone on a public X List, page by page, with profiles and DM availability. Costs 3 credits per page of about 20. Tip: curated lists (for example 'SaaS founders') are ready-made lead lists.

Parameters

Name	In	Type	Required	Default	Description
`id`	path	string	yes		List id or an x.com/i/lists/<id> URL.
`limit`	query	integer	no	`20`	Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100.
`cursor`	query	string	no		Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

id path, string, required: List id or an x.com/i/lists/<id> URL.
limit query, integer: Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100. Default 20.
cursor query, string: Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

Request examples

curl "https://chatterapi.com/v1/x/lists/1335924847940079620/members" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is a list of XUser, with page.nextCursor and page.hasMore for the next page. Fields:

Field	Type	Nullable	Description
`id`	string	no	Platform id.
`handle`	string	no	Handle without @.
`name`	string	no	Name.
`bio`	string	yes	Profile bio.
`followers`	number	yes	Follower count.
`following`	number	yes	Following count.
`tweets`	number	yes	Tweet count.
`verified`	boolean	yes	Legacy verification.
`blueVerified`	boolean	yes	Paid blue check.
`canDm`	boolean	yes	Whether the account accepts DMs from anyone.
`protected`	boolean	yes	Protected (private) account.
`location`	string	yes	Profile location.
`url`	string	yes	Website in the profile.
`avatarUrl`	string	yes	Avatar image URL.
`createdAt`	string	yes	ISO 8601 UTC timestamp.

response

{
  "data": [],
  "page": {
    "nextCursor": null,
    "hasMore": false
  },
  "credits": {
    "charged": 3,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-14, truncated to 3 items. Credits and request id are illustrative.

Credits

3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 6 hours are served from cache.

Errors this tool can return

Try it

Try in the playground Run it free without signup