List followers of a Twitter list
List accounts following (subscribed to) 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 category entries from X.
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
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/followers?url=https://x.com/i/lists/1227596802024771586" \
-H "x-api-key: YOUR_API_KEY"Responses
Followers of the requested list.