Headers
Get your API keyAPI key (`sfk_...`)
Tweet permalink or identifier.
min 1 chars · max 4096 chars
Optional: omit author profile and tweet `core` for a smaller response.
Endpoint-specific response payload.
Whether the tweet was found or unavailable.
one of: found, not_found
Author profile and metrics when not trimmed; null when `trim=true` or when not found.
Profile fields for the tweet author.
Social platform for this profile.
one of: twitter
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.
Whether X marks the profile with legacy verification (not necessarily paid blue).
Whether the account has X blue (paid) verification.
Canonical public profile URL on x.com.
min 1 chars
Whether the account is protected (private).
Numeric X user id (`rest_id`) as a string.
Account creation time as Unix epoch seconds when derivable.
≥ 0
Location string from the profile when provided.
Primary outbound link (expanded URL) from the profile.
Pinned tweet id when X exposes one.
Structured verification metadata from X.
Whether X marks the account as identity-verified.
When verification became effective, as milliseconds since epoch (string from X).
Verification reason payload when X provides it.
Human-readable verification reason text from X.
Inline entity metadata for the reason text (vendor-defined).
Tip jar configuration when present.
Whether the X tip jar is enabled.
Per-service handles when any are present.
Bandcamp handle from tip jar.
Bitcoin address or handle.
Cash App handle.
Ethereum address or handle.
GoFundMe handle.
Patreon handle.
PayPal handle.
Venmo handle.
Tweet highlights metadata when present.
Whether the account may highlight tweets on the profile.
Count of highlighted tweets when reported by X.
≥ 0
Opaque business-account payload from X when non-empty (vendor-defined).
Creator subscriptions count when X reports it.
≥ 0
Affiliate or business label when X provides one.
Affiliate or business label text shown on the profile.
Badge image URL when X provides one.
Destination URL for the label link.
Aggregate counts for the tweet author.
Follower count from X.
≥ 0
Following (friends) count from X.
≥ 0
Total post (status) count from X.
≥ 0
Total favourites (likes) count from X.
≥ 0
Listed count when X provides it.
≥ 0
Media item count when X provides it.
≥ 0
Fast-followers count when X provides it.
≥ 0
Tweet body, metrics, and optional quoted tweet; null when not found.
Tweet id (`rest_id`).
min 1 chars
Canonical public URL for this tweet on x.com.
min 1 chars
Conversation root tweet id.
min 1 chars
Creation time as Unix epoch seconds.
≥ 0
BCP 47 or X language code.
min 1 chars
Full tweet text (includes long-form when available).
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
Start/end character indices for visible text.
≥ 0
Engagement metrics for a tweet.
Impression count when reported by X.
≥ 0
Favorite (like) count.
≥ 0
Native repost count.
≥ 0
Reply count.
≥ 0
Bookmark count.
≥ 0
Quote tweet count.
≥ 0
Photo, video, or GIF attachments.
Entities aligned with `text`.
Hashtag entities.
Hashtag text without #.
User mention entities.
Mentioned screen name.
min 1 chars
Display name when available.
Numeric user id for the mention when available.
URL entities.
Short URL as it appears in text.
min 1 chars
Human-readable display host/path.
min 1 chars
Fully expanded destination URL.
min 1 chars
Symbol entities.
Cashtag or symbol text.
min 1 chars
Whether this is a reply.
Parent tweet id when replying.
Parent author user id when replying.
Parent author handle when replying.
Whether this tweet quotes another.
Quoted tweet id when present.
Whether this is a native repost.
Original tweet id for a repost.
Whether X marks the content sensitive.
Edit metadata when applicable.
Tweet ids in this edit chain.
min 1 chars
Epoch milliseconds until edits are locked.
Whether the tweet can still be edited.
Remaining edits in the window, as reported by X.
Client label text.
Link target from the source anchor when present.
Quoted tweet expanded one level (no further nesting on this field).
Tweet id (`rest_id`).
min 1 chars
Canonical public URL for this tweet on x.com.
min 1 chars
Conversation root tweet id.
min 1 chars
Creation time as Unix epoch seconds.
≥ 0
BCP 47 or X language code.
min 1 chars
Full tweet text (includes long-form when available).
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
Start/end character indices for visible text.
≥ 0
Author snapshot; null when `trim=true` omits per-tweet author data.
Author screen name without the leading @.
min 1 chars
Author display name.
Best available square avatar URL for the author.
Whether X marks the author with legacy verification.
Whether the author has X blue (paid) verification.
Numeric X user id for the author as a string.
Engagement metrics for a tweet.
Impression count when reported by X.
≥ 0
Favorite (like) count.
≥ 0
Native repost count.
≥ 0
Reply count.
≥ 0
Bookmark count.
≥ 0
Quote tweet count.
≥ 0
Photo, video, or GIF attachments.
Entities aligned with `text`.
Hashtag entities.
Hashtag text without #.
User mention entities.
Mentioned screen name.
min 1 chars
Display name when available.
Numeric user id for the mention when available.
URL entities.
Short URL as it appears in text.
min 1 chars
Human-readable display host/path.
min 1 chars
Fully expanded destination URL.
min 1 chars
Symbol entities.
Cashtag or symbol text.
min 1 chars
Whether this is a reply.
Parent tweet id when replying.
Parent author user id when replying.
Parent author handle when replying.
Whether this tweet quotes another.
Quoted tweet id when present.
Whether this is a native repost.
Original tweet id for a repost.
Whether X marks the content sensitive.
Edit metadata when applicable.
Tweet ids in this edit chain.
min 1 chars
Epoch milliseconds until edits are locked.
Whether the tweet can still be edited.
Remaining edits in the window, as reported by X.
Client label text.
Link target from the source anchor when present.
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
Code example
curl "https://api.socialfetch.dev/v1/twitter/tweets?url=https://x.com/elonmusk/status/2044990537145753894" \
-H "x-api-key: YOUR_API_KEY"Responses
Tweet details when available. Check `data.lookupStatus` for `found` vs `not_found`.