Twitter Tweet Detail API - Get a Tweet by ID

Fetch a tweet by ID

Retrieve detailed metadata for a specific tweet by ID including full text, media, engagement stats, and thread context. A post that does not exist or was deleted is a 404 tweet_not_found, final, not retryable and not billed (2026-11-13; before, it was a 200 with an empty result).

POST /tweet-detail Content
https://api.fetchlayer.dev/twitter/tweet-detail
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

tweetId string required

Tweet ID.

screenName string optional

Optional screen name context for URL construction.

timeoutMs integer optional

Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs.

Response Fields

tweet-detail

Fetch a tweet by ID

scrapedAt string

ISO 8601 time the result was produced.

transport string

The data source: always the platform id, "twitter".

entityType string

Always twitter-tweet-detail.

cached boolean

Present (true) only when the answer is a recent copy rather than a fresh read; scrapedAt then says when it was read. Only for a post at least 7 days old, and at most an hour old: counts and replies may lag by up to an hour.

tweet object | null

The tweet; null when it could not be found.

tweet.id string | null

Tweet id, as a string (it does not fit a JavaScript number).

tweet.conversationId string | null

Id of the thread’s first tweet.

tweet.createdAt string | null

When it was posted, as X writes it: "Fri Oct 23 23:37:56 +0000 2026" (UTC).

tweet.text string | null

Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links.

tweet.lang string | null

Language X detected for the text (BCP 47, e.g. en), or null.

tweet.source string | null

The posting client, when X says; usually null.

tweet.inReplyToStatusId string | null

For a reply, the id of the tweet it answers; null otherwise.

tweet.inReplyToUserId string | null

For a reply, the account id of the author it answers; null otherwise.

tweet.url string | null

Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id.

tweet.author object | null

Who posted it.

tweet.author.id string | null

The author’s numeric account id, as a string.

tweet.author.name string | null

Display name.

tweet.author.handle string | null

Handle without the @.

tweet.author.description string | null

Bio text, or null when the account has none.

tweet.author.followersCount integer | null

Followers of the author; null only when X leaves it out.

tweet.author.followingCount integer | null

Accounts the author follows; null only when X leaves it out.

tweet.author.verified boolean | null

Whether the account carries a verification checkmark.

tweet.author.avatarUrl string | null

Profile image URL (48x48).

tweet.author.pinnedTweetIds string[]

Ids of the pinned posts; empty when none.

tweet.author.website object | null

The website link on the profile; null when there is none.

tweet.author.website.url string | null

The t.co short link.

tweet.author.website.expandedUrl string | null

The full address it leads to.

tweet.author.website.displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

tweet.author.descriptionUrls object[]

Links in the bio, expanded; empty when none.

tweet.author.descriptionUrls[].url string | null

The t.co short link.

tweet.author.descriptionUrls[].expandedUrl string | null

The full address it leads to.

tweet.author.descriptionUrls[].displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

tweet.author.avatarUrlLarge string | null

The profile image at 400x400.

tweet.author.verifiedType string | null

The kind of verification, e.g. Business or Government; null for none.

tweet.author.protected boolean | null

True when the account’s posts are visible to its followers only.

tweet.counts.replies integer | null

Replies.

tweet.counts.reposts integer | null

Reposts (retweets).

tweet.counts.likes integer | null

Likes.

tweet.counts.quotes integer | null

Quote posts.

tweet.counts.bookmarks integer | null

Bookmarks.

tweet.counts.views integer | null

Views, or null when X shows none.

tweet.media object[]

Attached photos, videos and GIFs; empty when there are none.

tweet.media[].type string | null

photo, video or animated_gif.

tweet.media[].mediaUrl string | null

Image URL; for a video, its preview frame.

tweet.media[].expandedUrl string | null

Link to the media on x.com.

tweet.fullText string | null

The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post.

tweet.isLongPost boolean

True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped.

tweet.isQuote boolean

True when the post quotes another post.

tweet.quotedTweetId string | null

Id of the quoted post, also when that post is no longer available.

tweet.quotedTweet object | null

The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable.

tweet.isRetweet boolean

True when the post is a repost.

tweet.retweetedTweet object | null

The reposted post, one level deep like quotedTweet; null otherwise.

tweet.mediaDetails object[]

One entry per media item, in the same order: id, alt text, size and video files.

tweet.mediaDetails[].type string | null

photo, video or animated_gif.

tweet.mediaDetails[].mediaId string | null

The media id.

tweet.mediaDetails[].altText string | null

The alt text the author wrote; null when none.

tweet.mediaDetails[].width integer | null

Width of the original upload, in pixels.

tweet.mediaDetails[].height integer | null

Height of the original upload, in pixels.

tweet.mediaDetails[].video object | null

For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo.

tweet.entities object

What the text links to; for a long post, of fullText.

tweet.entities.urls object[]

Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead.

tweet.entities.hashtags string[]

Hashtags, without the #.

tweet.entities.mentions object[]

Accounts mentioned: handle, id and name.

tweet.entities.cashtags string[]

Cashtags, without the $.

tweet.card object | null

The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none.

tweet.poll object | null

For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise.

tweet.editControl object | null

Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining.

tweet.possiblySensitive boolean | null

X’s sensitive-media flag on the post.

tweet.communityNote object | null

The community note shown on the post: id, title (e.g. "Readers added context", it changes as the note is rated), text, language, url and urls[]. Null when there is none.

tweet.isPromoted boolean

True for an ad X placed in the list. It is kept in place, only labelled.

conversation object[]

Other tweets of the thread shown with it, each with the same fields as tweet.

conversation[].id string | null

Tweet id, as a string (it does not fit a JavaScript number).

conversation[].conversationId string | null

Id of the thread’s first tweet.

conversation[].createdAt string | null

When it was posted, as X writes it: "Fri Oct 23 23:37:56 +0000 2026" (UTC).

conversation[].text string | null

Full tweet text, complete for a long post too (2026-11-13: for a post over 280 characters it used to stop at about 280). Links appear as t.co short links.

conversation[].lang string | null

Language X detected for the text (BCP 47, e.g. en), or null.

conversation[].source string | null

The posting client, when X says; usually null.

conversation[].inReplyToStatusId string | null

For a reply, the id of the tweet it answers; null otherwise.

conversation[].inReplyToUserId string | null

For a reply, the account id of the author it answers; null otherwise.

conversation[].url string | null

Link to the tweet: https://x.com/<handle>/status/<id>, or https://x.com/i/status/<id> when the author is missing (x.com redirects it). Null only when the tweet has no id.

conversation[].author object | null

Who posted it.

conversation[].author.id string | null

The author’s numeric account id, as a string.

conversation[].author.name string | null

Display name.

conversation[].author.handle string | null

Handle without the @.

conversation[].author.description string | null

Bio text, or null when the account has none.

conversation[].author.followersCount integer | null

Followers of the author; null only when X leaves it out.

conversation[].author.followingCount integer | null

Accounts the author follows; null only when X leaves it out.

conversation[].author.verified boolean | null

Whether the account carries a verification checkmark.

conversation[].author.avatarUrl string | null

Profile image URL (48x48).

conversation[].author.pinnedTweetIds string[]

Ids of the pinned posts; empty when none.

conversation[].author.website object | null

The website link on the profile; null when there is none.

conversation[].author.website.url string | null

The t.co short link.

conversation[].author.website.expandedUrl string | null

The full address it leads to.

conversation[].author.website.displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

conversation[].author.descriptionUrls object[]

Links in the bio, expanded; empty when none.

conversation[].author.descriptionUrls[].url string | null

The t.co short link.

conversation[].author.descriptionUrls[].expandedUrl string | null

The full address it leads to.

conversation[].author.descriptionUrls[].displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

conversation[].author.avatarUrlLarge string | null

The profile image at 400x400.

conversation[].author.verifiedType string | null

The kind of verification, e.g. Business or Government; null for none.

conversation[].author.protected boolean | null

True when the account’s posts are visible to its followers only.

conversation[].counts.replies integer | null

Replies.

conversation[].counts.reposts integer | null

Reposts (retweets).

conversation[].counts.likes integer | null

Likes.

conversation[].counts.quotes integer | null

Quote posts.

conversation[].counts.bookmarks integer | null

Bookmarks.

conversation[].counts.views integer | null

Views, or null when X shows none.

conversation[].media object[]

Attached photos, videos and GIFs; empty when there are none.

conversation[].media[].type string | null

photo, video or animated_gif.

conversation[].media[].mediaUrl string | null

Image URL; for a video, its preview frame.

conversation[].media[].expandedUrl string | null

Link to the media on x.com.

conversation[].fullText string | null

The complete text, with &amp;, &lt; and &gt; unescaped. For a long post it equals text, which carries the whole post.

conversation[].isLongPost boolean

True for a post in X’s long-post format. text carries all of it; fullText is the same text with &amp;, &lt; and &gt; unescaped.

conversation[].isQuote boolean

True when the post quotes another post.

conversation[].quotedTweetId string | null

Id of the quoted post, also when that post is no longer available.

conversation[].quotedTweet object | null

The quoted post, with the same fields as this one, one level deep (its own quotedTweet and retweetedTweet are null). Null when nothing is quoted or the quoted post is unavailable.

conversation[].isRetweet boolean

True when the post is a repost.

conversation[].retweetedTweet object | null

The reposted post, one level deep like quotedTweet; null otherwise.

conversation[].mediaDetails object[]

One entry per media item, in the same order: id, alt text, size and video files.

conversation[].mediaDetails[].type string | null

photo, video or animated_gif.

conversation[].mediaDetails[].mediaId string | null

The media id.

conversation[].mediaDetails[].altText string | null

The alt text the author wrote; null when none.

conversation[].mediaDetails[].width integer | null

Width of the original upload, in pixels.

conversation[].mediaDetails[].height integer | null

Height of the original upload, in pixels.

conversation[].mediaDetails[].video object | null

For a video or GIF: durationMs (null for a GIF), aspectRatio as [width, height], and variants[] of MP4 files with url, contentType and bitrate. Null for a photo.

conversation[].entities object

What the text links to; for a long post, of fullText.

conversation[].entities.urls object[]

Links in the text, expanded (url, expandedUrl, displayUrl). Media links are in media instead.

conversation[].entities.hashtags string[]

Hashtags, without the #.

conversation[].entities.mentions object[]

Accounts mentioned: handle, id and name.

conversation[].entities.cashtags string[]

Cashtags, without the $.

conversation[].card object | null

The link preview: name (the card type, e.g. summary_large_image), url, title, description, domain and imageUrl. Null when there is none.

conversation[].poll object | null

For a poll: choices[] (label and votes so far as count), endsAt (ISO 8601), isFinal (true once closed) and durationMinutes. Null otherwise.

conversation[].editControl object | null

Edit history: editTweetIds (every version, oldest first; one id when never edited), isEditEligible, editableUntil (ISO 8601) and editsRemaining.

conversation[].possiblySensitive boolean | null

X’s sensitive-media flag on the post.

conversation[].communityNote object | null

The community note shown on the post: id, title (e.g. "Readers added context", it changes as the note is rated), text, language, url and urls[]. Null when there is none.

conversation[].isPromoted boolean

True for an ad X placed in the list. It is kept in place, only labelled.

Request

curl -X POST "https://api.fetchlayer.dev/twitter/tweet-detail" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"tweetId":"2113776971603689874"}'

Response

{
  "entityType": "twitter-tweet-detail",
  "tweet": {
    "id": "2113776971603689874",
    "conversationId": "2113776971603689874",
    "createdAt": "Fri Oct 23 23:37:56 +0000 2026",
    "text": "We are not slowing down. 🚀 Our Artemis II crew is training for their trip around the Moon.",
    "lang": "en",
    "source": null,
    "inReplyToStatusId": null,
    "inReplyToUserId": null,
    "url": "https://x.com/NASA/status/2113776971603689874",
    "author": {
      "id": "11348282",
      "name": "NASA",
      "handle": "NASA",
      "description": "Making the seemingly impossible, possible. ✨",
      "followersCount": 92312272,
      "followingCount": 115,
      "verified": true
    },
    "counts": {
      "replies": 339,
      "reposts": 970,
      "likes": 7439,
      "quotes": 83,
      "bookmarks": 341,
      "views": 1273965
    },
    "media": [
      {
        "type": "video",
        "mediaUrl": "https://pbs.twimg.com/media/HVWk812WIAAg_hz.jpg",
        "expandedUrl": "https://x.com/NASA/status/2113776971603689874/video/1"
      }
    ]
  },
  "conversation": [],
  "scrapedAt": "2026-10-25T19:10:02.112Z",
  "transport": "twitter"
}
Product overview Twitter API: what it returns, pricing and use cases