Skip to content

Tweet Details and Conversation

GET/tw-v2/tweet/details

1 API unit per call · How billing works

Description

Get detailed information about a specific tweet including full metadata, engagement metrics, attached X Article content, its parent tweets (ancestors, oldest first) when it is a reply, and a page of replies.

Parameters

ParameterDescription
tweetIdstringrequiredUnique tweet/post ID
cursorstringoptionalPagination cursor for fetching next page of results. Obtained from previous response.
sortBystringoptionalSort order for conversation replies (Relevance, Recency, Likes). Default: Relevance

Code Examples

const params = new URLSearchParams({
  tweetId: '1234567890'
});

const response = await fetch(`https://api.tweetapi.com/tw-v2/tweet/details?${params}`, {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

The example shows the main fields. The Tweet Object reference describes every field of a tweet, including fullText, entities and the raw card values.

200
{
  "data": {
    "tweet": {
      "id": "5003666593753562724",
      "conversationId": "5003666593753562700",
      "text": "Sample post text 47487 for documentation.",
      "displayTextRange": [
        0,
        99
      ],
      "author": {
        "id": "10030086",
        "username": "sample_user_92303",
        "name": "Sample User 92303",
        "bio": "Sample profile bio for Sample User 92303.",
        "location": "Sample City 731",
        "website": "https://example.com/link-94089/profile-29900/profile-84577",
        "pinnedTweetIds": [
          "2001104869074971439"
        ],
        "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-84577.jpg",
        "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-84577.jpg",
        "profileImageShape": "Circle",
        "verified": false,
        "isBlueVerified": true,
        "verifiedType": null,
        "verifiedSince": null,
        "isIdentityVerified": false,
        "isProtected": false,
        "possiblySensitive": false,
        "profileInterstitialType": null,
        "withheldInCountries": [],
        "professional": {
          "type": "Business",
          "category": [
            {
              "id": 579,
              "name": "Media & News",
              "icon_name": "IconBriefcaseStroke"
            }
          ],
          "restId": "7001747894951294611"
        },
        "businessAccount": null,
        "creatorSubscriptionsCount": 0,
        "hasHiddenSubscriptions": false,
        "highlightsInfo": null,
        "hasGraduatedAccess": true,
        "isProfileTranslatable": false,
        "hasCustomTimelines": false,
        "isTranslator": false,
        "affiliatesHighlightedLabel": {},
        "defaultProfile": false,
        "defaultProfileImage": false,
        "followerCount": 732200,
        "followingCount": 68,
        "tweetCount": 106693,
        "listedCount": 0,
        "mediaCount": 48095,
        "favoritesCount": 2077,
        "createdAt": "2009-02-10T20:27:09.000Z"
      },
      "source": null,
      "type": "reply",
      "replyTo": {
        "tweetId": "5003666593753562700",
        "userId": "10030086",
        "username": "sample_user_92303"
      },
      "quotedTweet": null,
      "retweetedTweet": null,
      "reactionContext": {
        "isReaction": true,
        "targetTweetId": "2000000000000000001",
        "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001",
        "targetAuthor": {
          "id": "1000000000000000001",
          "username": "sample_user_00001",
          "name": "Sample User 00001",
          "avatar": "https://example.com/images/sample-avatar-00001.jpg",
          "isBlueVerified": true
        }
      },
      "likeCount": 3,
      "retweetCount": 1,
      "replyCount": 0,
      "quoteCount": 0,
      "bookmarkCount": 0,
      "viewCount": 1977,
      "media": [],
      "poll": null,
      "card": {
        "name": "",
        "url": "https://example.com/link-94089/profile-29900/link-06903",
        "cardType": "",
        "type": "summary",
        "bindingValues": {
          "title": "",
          "description": "",
          "domain": "",
          "thumbnailImageUrl": null,
          "thumbnailImageColor": null,
          "playerUrl": null,
          "playerWidth": null,
          "playerHeight": null,
          "appId": null,
          "appName": null,
          "appStarRating": null,
          "appPriceAmount": null,
          "appPriceCurrency": null
        },
        "cardPlatform": {
          "platform": {
            "device": {
              "name": "",
              "version": ""
            },
            "audience": {
              "name": ""
            }
          }
        },
        "vanityUrl": null,
        "userRefsResults": null
      },
      "article": null,
      "hashtags": [
        "sample_topic_28432"
      ],
      "mentions": [],
      "urls": [
        "https://example.com/link-94089/profile-29900/profile-84577/articles/25/10/01/lowest-price-ever-apple-watch-se-2-gps-cellular-plunges-to-189?utm_source=rss&utm_source=rss&utm_medium=Sendible&utm_campaign=RSS"
      ],
      "symbols": [],
      "possiblySensitive": false,
      "limitedActions": null,
      "isEdited": false,
      "editControl": null,
      "isTranslatable": false,
      "lang": "en",
      "translatedText": null,
      "hasBirdwatchNotes": false,
      "birdwatchPivot": null,
      "conversationControl": null,
      "isPromoted": false,
      "promotedMetadata": null,
      "createdAt": "2025-10-02T05:00:19.000Z",
      "place": null,
      "communityId": null,
      "communityResults": null
    },
    "ancestors": [
      {
        "id": "5003666593753562700",
        "conversationId": "5003666593753562700",
        "text": "Sample parent post text 47410 for documentation.",
        "displayTextRange": [
          0,
          48
        ],
        "author": {
          "id": "10030086",
          "username": "sample_user_92303",
          "name": "Sample User 92303",
          "bio": "Sample profile bio for Sample User 92303.",
          "location": "Sample City 731",
          "website": "https://example.com/link-94089/profile-29900/profile-84577",
          "pinnedTweetIds": [
            "2001104869074971439"
          ],
          "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-84577.jpg",
          "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-84577.jpg",
          "profileImageShape": "Circle",
          "verified": false,
          "isBlueVerified": true,
          "verifiedType": null,
          "verifiedSince": null,
          "isIdentityVerified": false,
          "isProtected": false,
          "possiblySensitive": false,
          "profileInterstitialType": null,
          "withheldInCountries": [],
          "professional": {
            "type": "Business",
            "category": [
              {
                "id": 579,
                "name": "Media & News",
                "icon_name": "IconBriefcaseStroke"
              }
            ],
            "restId": "7001747894951294611"
          },
          "businessAccount": null,
          "creatorSubscriptionsCount": 0,
          "hasHiddenSubscriptions": false,
          "highlightsInfo": null,
          "hasGraduatedAccess": true,
          "isProfileTranslatable": false,
          "hasCustomTimelines": false,
          "isTranslator": false,
          "affiliatesHighlightedLabel": {},
          "defaultProfile": false,
          "defaultProfileImage": false,
          "followerCount": 732200,
          "followingCount": 68,
          "tweetCount": 106693,
          "listedCount": 0,
          "mediaCount": 48095,
          "favoritesCount": 2077,
          "createdAt": "2009-02-10T20:27:09.000Z"
        },
        "source": null,
        "type": "tweet",
        "replyTo": null,
        "quotedTweet": null,
        "retweetedTweet": null,
        "reactionContext": null,
        "likeCount": 41,
        "retweetCount": 6,
        "replyCount": 1,
        "quoteCount": 0,
        "bookmarkCount": 0,
        "viewCount": 8120,
        "media": [],
        "poll": null,
        "card": null,
        "article": null,
        "hashtags": [],
        "mentions": [],
        "urls": [],
        "symbols": [],
        "possiblySensitive": false,
        "limitedActions": null,
        "isEdited": false,
        "editControl": null,
        "isTranslatable": false,
        "lang": "en",
        "translatedText": null,
        "hasBirdwatchNotes": false,
        "birdwatchPivot": null,
        "conversationControl": null,
        "isPromoted": false,
        "promotedMetadata": null,
        "createdAt": "2025-10-02T04:41:07.000Z",
        "place": null,
        "communityId": null,
        "communityResults": null
      }
    ],
    "replies": [],
    "nextCursor": "NEXT_CURSOR"
  }
}

Parent Tweets and Replies

The response contains the requested tweet in tweet, its parent tweets in ancestors, and a page of replies in replies. ancestors lists the tweets above a reply, oldest first, ending with the direct parent, so you get the conversation it belongs to without extra calls. It is empty when the tweet is not a reply. Pass nextCursor as cursor to fetch more replies; cursor pages return tweet: null and an empty ancestors list.

X Article Attachments

When a tweet contains an X Article, the returned tweet object includes an article object. The tweet's text remains the original post text or Article URL; the complete readable body is returned in article.text. For tweets without an Article, article is null.

{
  "text": "https://x.com/i/article/1234567890123456789",
  "article": {
    "id": "1234567890123456789",
    "title": "Example Article Title",
    "text": "The complete readable Article body...",
    "previewText": "A short preview of the Article...",
    "coverImageUrl": "https://example.com/images/sample-article-cover.jpg"
  }
}