List members of a Twitter list
List member accounts of an X list, by list URL or id.
Headers
Get your API keyAPI key (`sfk_...`)
List permalink or numeric id.
min 1 chars · max 4096 chars
Opaque pagination cursor returned by a previous response.
min 1 chars
Endpoint-specific response payload.
Whether the user list was resolved.
one of: found, not_found, private
Users returned for this page.
Numeric X user id as a string.
X screen name (handle) without the leading @.
Display name shown on the profile.
Profile biography text.
Best available square avatar image URL.
Profile banner image URL when available.
Location string from the profile when provided.
Primary outbound link (expanded URL) from the profile.
Whether X marks the profile with legacy verification (not necessarily paid blue).
Whether the account has X blue (paid) verification.
Whether the account is protected (private).
Follower count from X when available.
≥ 0
Following (friends) count from X when available.
≥ 0
Total post (status) count from X when available.
≥ 0
Listed count when X provides it.
≥ 0
Account creation time (ISO-8601) when derivable.
Canonical public profile URL on x.com (`https://x.com/<handle>`).
Avatar crop shape reported by X, such as Circle or Square.
X verification type label when provided (for example a government or organization note).
Pinned tweet ids from X, in display order.
X professional-account metadata when the account is marked professional.
Professional account type from X, when present.
Professional categories X shows on the profile.
X's numeric id for the category.
Category name shown on the profile, such as `Science & Technology`.
X's icon name for the category, such as `IconBriefcaseStroke`.
Professional account rest id from X, when present.
Country codes where the profile is withheld.
Total likes (favorites) on the profile when available.
≥ 0
Media item count when X provides it.
≥ 0
Affiliation or automated-account label shown next to the name, when X provides one.
Affiliate or business label text shown on the profile.
Badge image URL when X provides one.
Destination URL for the label link.
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
Longer label text when X provides one, such as `Automated by @owner`.
Cursor pagination for this user list.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/twitter/lists/members?url=https://x.com/i/lists/1227596802024771586" \
-H "x-api-key: YOUR_API_KEY"Responses
Members of the requested list.