List Twitter profile tweets
List tweets from an X profile by handle — List Twitter profile tweets.
Headers
Get your API keyAPI key (`sfk_...`)
X handle to look up, with or without a leading @.
Page size (maximum 100). Default: 40.
Opaque pagination cursor returned by a previous response.
min 1 chars
Include reply tweets in the returned list. Default: false.
Include pinned tweets on the first page. Default: false.
Endpoint-specific response payload.
Whether tweet data was returned for this handle.
one of: found, not_found
Profile card derived from the first returned tweet when available; null when not found or when no tweet rows include author data.
Social platform for this profile.
one of: twitter
Screen name without @.
min 1 chars
Display name for the profile.
Profile bio when reported by the upstream provider.
Profile location when reported by the upstream provider.
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 as Unix epoch seconds.
≥ 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
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.
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/charlidamelio/tweets" \
-H "x-api-key: YOUR_API_KEY"Responses
Tweets for the requested profile.