Headers
Get your API keyAPI key (`sfk_...`)
List permalink or numeric id.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the list was found.
one of: found, not_found, private
List details when available.
Numeric list identifier as a string.
min 1 chars
List display name.
List description text when available.
Whether the list is private.
Canonical public list URL on x.com (`https://x.com/i/lists/{id}`).
min 1 chars
List banner image URL when available.
Approximate member count when available.
≥ 0
Approximate subscriber (follower) count when available.
≥ 0
List creation time (ISO-8601) when available.
List owner compact user card when available.
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
List slug when X provides one.
List URI when X provides one.
Member avatar URLs shown in the list preview.
min 1 chars
Default banner media payload when X provides one.
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?url=https://x.com/i/lists/1227596802024771586" \
-H "x-api-key: YOUR_API_KEY"Responses
List details.