List Twitter profile tweets
List tweets from an X profile by handle or numeric user id.
Headers
Get your API keyAPI key (`sfk_...`)
X (Twitter) profile handle without the leading @, or a numeric user id.
Requested page size (1–100). Best-effort; the actual page size may differ.
≥ 1 · ≤ 100
Opaque pagination cursor returned by a previous response.
min 1 chars
When true, includes reply tweets. Defaults to false.
When true, includes the pinned tweet when available.
Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits.
one of: id, handle
Endpoint-specific response payload.
Whether the handle resolved for this list request. `found` means the handle resolved; `not_found` means it did not. `found` may still include an empty `tweets` array when the profile has no eligible tweets in the returned page.
one of: found, not_found
Profile card from the resolved user when the handle was looked up, otherwise from the first tweet author; null when neither is available.
Social platform for this profile.
one of: twitter
Screen name without @.
min 1 chars
Display name for the profile.
Profile bio when the account includes one.
Profile location when the account includes one.
Best available square avatar URL.
Profile banner image URL when available.
Legacy verified flag from X.
Paid blue verification flag from X.
Canonical profile URL on x.com.
min 1 chars
Numeric user id as a string.
Tweets returned for the requested profile page. May be empty when `lookupStatus` is `found` and no eligible tweets are returned, or when `lookupStatus` is `not_found`.
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.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when another page exists.
Whether another page can be requested.
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/profiles/nasa/tweets" \
-H "x-api-key: YOUR_API_KEY"Responses
Tweets for the requested profile.