List tweets from a Twitter list
List recent tweets from members 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 tweet list was resolved.
one of: found, not_found, private
Tweets returned for this page.
Tweet id.
min 1 chars
Canonical public URL for the tweet when available.
Full tweet text when available.
Creation time (ISO-8601).
Human-readable creation timestamp string when available.
Language code for the tweet when available.
Conversation identifier when supplied.
min 1 chars
Parent post identifier when this post is a reply.
min 1 chars
Quoted post identifier when this post quotes another.
min 1 chars
Original post identifier when this post is an engagement repost.
min 1 chars
Author metadata for the tweet when available.
Author handle without the leading @.
min 1 chars
Display name shown for the author.
Profile image URL for the author when available.
Canonical public profile URL for the author when available.
Whether the author has legacy verification on X.
Whether the author has paid blue verification on X.
Numeric X user id for the author as a string.
Engagement metrics for a tweet.
Like count.
≥ 0
Retweet count.
≥ 0
Reply count.
≥ 0
Quote count.
≥ 0
View count when available.
≥ 0
Bookmark count when available.
≥ 0
Media attachments returned for the tweet.
Direct media URL when available.
min 1 chars
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
Poster or thumbnail URL for video media when distinguishable.
min 1 chars
MIME type reported for streamed media.
min 1 chars
Bitrate in bits per second when supplied for streamed media.
≥ 0
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Expanded URL attached to the tweet when available.
Whether the tweet is marked as a retweet.
Whether the tweet is a reply to another post.
Whether the tweet quotes another post.
Source label such as `Twitter Web App` when available.
Community id when the tweet was posted to a community.
Whether X marks the tweet as containing AI-generated media.
Whether X marks the tweet as a paid promotion.
Whether X considers the tweet text translatable.
Whether Community Notes are attached to this tweet.
Quoted tweet expanded one level (no further nesting).
Tweet id.
min 1 chars
Canonical public URL for the tweet when available.
Full tweet text when available.
Creation time (ISO-8601).
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
≥ 0
Human-readable creation timestamp string when available.
Language code for the tweet when available.
Conversation identifier when supplied.
min 1 chars
Parent post identifier when this post is a reply.
min 1 chars
Quoted post identifier when this post quotes another.
min 1 chars
Original post identifier when this post is an engagement repost.
min 1 chars
Author metadata for the tweet when available.
Author handle without the leading @.
min 1 chars
Display name shown for the author.
Profile image URL for the author when available.
Canonical public profile URL for the author when available.
Whether the author has legacy verification on X.
Whether the author has paid blue verification on X.
Numeric X user id for the author as a string.
Engagement metrics for a tweet.
Like count.
≥ 0
Retweet count.
≥ 0
Reply count.
≥ 0
Quote count.
≥ 0
View count when available.
≥ 0
Bookmark count when available.
≥ 0
Media attachments returned for the tweet.
Direct media URL when available.
min 1 chars
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
Poster or thumbnail URL for video media when distinguishable.
min 1 chars
MIME type reported for streamed media.
min 1 chars
Bitrate in bits per second when supplied for streamed media.
≥ 0
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Expanded URL attached to the tweet when available.
Whether the tweet is marked as a retweet.
Whether the tweet is a reply to another post.
Whether the tweet quotes another post.
Source label such as `Twitter Web App` when available.
Community id when the tweet was posted to a community.
Whether X marks the tweet as containing AI-generated media.
Whether X marks the tweet as a paid promotion.
Whether X considers the tweet text translatable.
Whether Community Notes are attached to this tweet.
Reposted tweet expanded one level (no further nesting).
Tweet id.
min 1 chars
Canonical public URL for the tweet when available.
Full tweet text when available.
Creation time (ISO-8601).
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
≥ 0
Human-readable creation timestamp string when available.
Language code for the tweet when available.
Conversation identifier when supplied.
min 1 chars
Parent post identifier when this post is a reply.
min 1 chars
Quoted post identifier when this post quotes another.
min 1 chars
Original post identifier when this post is an engagement repost.
min 1 chars
Author metadata for the tweet when available.
Author handle without the leading @.
min 1 chars
Display name shown for the author.
Profile image URL for the author when available.
Canonical public profile URL for the author when available.
Whether the author has legacy verification on X.
Whether the author has paid blue verification on X.
Numeric X user id for the author as a string.
Engagement metrics for a tweet.
Like count.
≥ 0
Retweet count.
≥ 0
Reply count.
≥ 0
Quote count.
≥ 0
View count when available.
≥ 0
Bookmark count when available.
≥ 0
Media attachments returned for the tweet.
Direct media URL when available.
min 1 chars
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
Poster or thumbnail URL for video media when distinguishable.
min 1 chars
MIME type reported for streamed media.
min 1 chars
Bitrate in bits per second when supplied for streamed media.
≥ 0
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Expanded URL attached to the tweet when available.
Whether the tweet is marked as a retweet.
Whether the tweet is a reply to another post.
Whether the tweet quotes another post.
Source label such as `Twitter Web App` when available.
Community id when the tweet was posted to a community.
Whether X marks the tweet as containing AI-generated media.
Whether X marks the tweet as a paid promotion.
Whether X considers the tweet text translatable.
Whether Community Notes are attached to this tweet.
Cursor pagination for this tweet 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/tweets?url=https://x.com/i/lists/1227596802024771586" \
-H "x-api-key: YOUR_API_KEY"Responses
Tweets from the requested X list.