Headers
Get your API keyAPI key (`sfk_...`)
Tweet permalink or numeric id.
min 1 chars · max 4096 chars
Optional: omit the author profile card 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 as a string.
Account creation time (ISO-8601) when derivable.
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.
Whether X marks the account as blue-verified. Same signal as `blueVerified`.
X verification type label when provided (for example a government or organization note).
Pinned tweet ids from X, in display order.
Total likes (favorites) on the profile. Prefer `metrics.favourites`.
≥ 0
Account creation time as returned by X (raw upstream string). Prefer `accountCreatedAt` for ISO-8601.
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.
Avatar crop shape reported by X, such as Circle or Square.
When X verification became effective (ISO-8601). Invalid dates are null. Prefer this over `verificationInfo.verifiedSinceMsec`.
Whether X marks the profile as possibly sensitive.
Interstitial type shown on the profile when X reports one.
Whether creator subscriptions are hidden on the profile.
Whether X reports graduated access for this account.
Whether X considers the profile text translatable.
Whether the account has custom timelines.
Whether X marks the account as a translator.
Whether the account still uses the default profile theme.
Whether the account still uses the default avatar.
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.
min 1 chars
Canonical public URL for this tweet on x.com.
min 1 chars
Conversation root tweet id.
min 1 chars
Creation time (ISO-8601).
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.
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 on this field). Null when this is not a quote.
Tweet 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 (ISO-8601).
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 when available.
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.
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 on this field). Null when this is not a repost.
Tweet 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 (ISO-8601).
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
≥ 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 when available.
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.
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.
Tweet kind: `tweet`, `reply`, `quote`, or `retweet`.
Parent tweet when this is a reply.
Parent tweet id.
Parent author user id.
Parent author handle.
Poll when the tweet contains one.
Poll id.
Poll choices.
Poll choice id.
Poll choice label.
Votes for this choice.
≥ 0
Share of votes for this choice, as a whole percent.
≥ 0
When voting ends, as reported by X.
Configured poll duration in minutes.
≥ 0
Poll voting status (for example `closed`).
Total votes across all choices.
≥ 0
Article title and preview when present.
Article title.
Short preview of the article body.
Whether the tweet has been edited.
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/tweets?url=https://x.com/elonmusk/status/2044990537145753894" \
-H "x-api-key: YOUR_API_KEY"Responses
Tweet details.