Details By IDs

GET/tw-v2/tweet/details-by-ids

Description

Retrieve detailed information for multiple tweets in a single request. Returns comprehensive tweet data including author information, engagement metrics, media attachments, and metadata for up to 200 tweets at once.

Parameters

ParameterTypeRequiredDescription
idsstringrequiredComma-separated list of tweet IDs to retrieve (maximum 200 IDs per request)

Code Examples

const tweetIds = ['1998699600589521037', '1998755920940245377', '1998539993883750584'];

const params = new URLSearchParams({
  ids: tweetIds.join(',')
});

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

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

Response

Success Response (200 OK)

200
{
  "data": {
    "tweets": [
      {
        "id": "1998699600589521037",
        "conversationId": "1998699600589521037",
        "text": "I was in Dubai last weekend for F1 as @Gate invited me to experience the Paddock Club and man that was something else.\n\ni've watched F1 for years but seeing it from that close was an amazing experience\n\nstanding right above the garages, watching the teams prep, hearing the cars fire up… unreal.\n\neven got to walk through the pit lane.. seeing how fast those mechanics operate, how everything is coordinated down to milliseconds…\n\nhuge thanks to @Gate for bringing me in and giving me the chance to see all of this up close. \n\none of the nicest experiences i've had this year.. \n\nand if you're even slightly into F1, i'd genuinely recommend trying this, Gate is giving away VIP paddock passes for the next race. entry link:\n\n👉 https://t.co/qSOkBcCJqj\n\nquick notes about @Gate:\n\n- globally open, no issues\n- while doing KYC, choose \"Other\" for Country/Region (if your country doesn't appear)\n- top-3 CEX and runs a solid, safe platform\n\nif you win this, trust me… the paddock club is absolutely worth it. good luck!",
        "displayTextRange": [
          0,
          278
        ],
        "author": {
          "id": "3168947216",
          "username": "Axel_bitblaze69",
          "name": "Axel Bitblaze 🪓",
          "bio": "Low iq idiot. I know nothing. Telegram: @Axelbitblaze |",
          "location": "On chain",
          "website": "https://t.me/Alpha_Updates",
          "pinnedTweetIds": [
            "1996631094914113823"
          ],
          "avatar": "https://pbs.twimg.com/profile_images/1883446587822608384/6eprnWjH_normal.jpg",
          "banner": "https://pbs.twimg.com/profile_banners/3168947216/1717522528/1500x500",
          "profileImageShape": "Circle",
          "verified": false,
          "isBlueVerified": true,
          "verifiedType": null,
          "verifiedSince": null,
          "isIdentityVerified": false,
          "isProtected": false,
          "possiblySensitive": false,
          "profileInterstitialType": null,
          "withheldInCountries": [],
          "professional": {
            "type": "Creator",
            "category": [
              {
                "id": 1009,
                "name": "Community",
                "icon_name": "IconBriefcaseStroke"
              }
            ],
            "restId": "1612175632120811521"
          },
          "businessAccount": null,
          "creatorSubscriptionsCount": 0,
          "hasHiddenSubscriptions": false,
          "highlightsInfo": null,
          "hasGraduatedAccess": true,
          "isProfileTranslatable": false,
          "hasCustomTimelines": true,
          "isTranslator": false,
          "affiliatesHighlightedLabel": {
            "label": {
              "url": {
                "url": "https://twitter.com/Lombard_Finance",
                "urlType": "DeepLink"
              },
              "badge": {
                "url": "https://pbs.twimg.com/profile_images/1945866084202004480/sF1I4lkP_bigger.jpg"
              },
              "description": "Lombard",
              "userLabelType": "BusinessLabel",
              "userLabelDisplayType": "Badge"
            }
          },
          "defaultProfile": true,
          "defaultProfileImage": false,
          "followerCount": 126041,
          "followingCount": 1111,
          "tweetCount": 43934,
          "listedCount": 1889,
          "mediaCount": 6617,
          "favoritesCount": 143026,
          "createdAt": "2015-04-23T15:32:31.000Z"
        },
        "source": null,
        "type": "tweet",
        "replyTo": null,
        "quotedTweet": null,
        "retweetedTweet": null,
        "likeCount": 55,
        "retweetCount": 0,
        "replyCount": 20,
        "quoteCount": 1,
        "bookmarkCount": 2,
        "viewCount": 2615,
        "media": [
          {
            "id": "1998698250552094723",
            "key": "13_1998698250552094723",
            "type": "video",
            "url": "https://video.twimg.com/amplify_video/1998698250552094723/vid/avc1/2160x3840/Z3obJK5IDE1jzCBI.mp4?tag=21",
            "displayUrl": "pic.x.com/H8tUFQMiIM",
            "expandedUrl": "https://x.com/Axel_bitblaze69/status/1998699600589521037/video/1",
            "thumbnailUrl": "https://pbs.twimg.com/amplify_video_thumb/1998698250552094723/img/9enbqK2eZ3tkw6he.jpg",
            "width": 2160,
            "height": 3840,
            "aspectRatio": [
              9,
              16
            ],
            "sizes": {
              "thumb": {
                "width": 150,
                "height": 150,
                "resize": "crop"
              },
              "small": {
                "width": 383,
                "height": 680,
                "resize": "fit"
              },
              "medium": {
                "width": 675,
                "height": 1200,
                "resize": "fit"
              },
              "large": {
                "width": 1152,
                "height": 2048,
                "resize": "fit"
              },
              "original": {
                "width": 2160,
                "height": 3840,
                "resize": "fit"
              }
            },
            "duration": 11,
            "bitrate": null,
            "videoInfo": {
              "variants": [
                {
                  "bitrate": 0,
                  "contentType": "application/x-mpegURL",
                  "url": "https://video.twimg.com/amplify_video/1998698250552094723/pl/3bglEp-A-Pojz0jT.m3u8?tag=21&v=a6d"
                },
                {
                  "bitrate": 632000,
                  "contentType": "video/mp4",
                  "url": "https://video.twimg.com/amplify_video/1998698250552094723/vid/avc1/320x568/SHQLJ0044E7kbba_.mp4?tag=21"
                },
                {
                  "bitrate": 950000,
                  "contentType": "video/mp4",
                  "url": "https://video.twimg.com/amplify_video/1998698250552094723/vid/avc1/480x852/dgz2ud9kkn_pAJyW.mp4?tag=21"
                },
                {
                  "bitrate": 2176000,
                  "contentType": "video/mp4",
                  "url": "https://video.twimg.com/amplify_video/1998698250552094723/vid/avc1/720x1280/H3pEdrEx8rc0oVUU.mp4?tag=21"
                },
                {
                  "bitrate": 10368000,
                  "contentType": "video/mp4",
                  "url": "https://video.twimg.com/amplify_video/1998698250552094723/vid/avc1/1080x1920/V2y98NNmFL9INbQV.mp4?tag=21"
                },
                {
                  "bitrate": 25128000,
                  "contentType": "video/mp4",
                  "url": "https://video.twimg.com/amplify_video/1998698250552094723/vid/avc1/2160x3840/Z3obJK5IDE1jzCBI.mp4?tag=21"
                }
              ],
              "durationMillis": 10921
            },
            "altText": null,
            "sensitiveMedia": false,
            "features": {
              "all": [],
              "large": [],
              "medium": [],
              "small": [],
              "orig": [
                {
                  "faces": []
                }
              ]
            },
            "mediaAvailability": {
              "status": "Available",
              "reason": null
            },
            "allowDownload": true,
            "mediaStats": null,
            "processingInfo": null,
            "sourceStatusId": null,
            "sourceUserId": null,
            "stickers": null
          },
          {
            "id": "1998698446874882049",
            "key": "3_1998698446874882049",
            "type": "photo",
            "url": "https://pbs.twimg.com/media/G7zNpdsaMAEsWyj.jpg",
            "displayUrl": "pic.x.com/H8tUFQMiIM",
            "expandedUrl": "https://x.com/Axel_bitblaze69/status/1998699600589521037/video/1",
            "thumbnailUrl": "https://pbs.twimg.com/media/G7zNpdsaMAEsWyj.jpg",
            "width": 1320,
            "height": 2295,
            "aspectRatio": [
              88,
              153
            ],
            "sizes": {
              "thumb": {
                "width": 150,
                "height": 150,
                "resize": "crop"
              },
              "small": {
                "width": 391,
                "height": 680,
                "resize": "fit"
              },
              "medium": {
                "width": 690,
                "height": 1200,
                "resize": "fit"
              },
              "large": {
                "width": 1178,
                "height": 2048,
                "resize": "fit"
              },
              "original": {
                "width": 1320,
                "height": 2295,
                "resize": "fit"
              }
            },
            "duration": null,
            "bitrate": null,
            "videoInfo": null,
            "altText": null,
            "sensitiveMedia": false,
            "features": {
              "all": [],
              "large": [],
              "medium": [],
              "small": [],
              "orig": [
                {
                  "faces": []
                }
              ]
            },
            "mediaAvailability": {
              "status": "Available",
              "reason": null
            },
            "allowDownload": true,
            "mediaStats": null,
            "processingInfo": null,
            "sourceStatusId": null,
            "sourceUserId": null,
            "stickers": null
          }
        ],
        "poll": null,
        "card": null,
        "hashtags": [],
        "mentions": [
          {
            "id": "912539725071777792",
            "username": "Gate",
            "name": "Gate"
          }
        ],
        "urls": [
          "https://www.gate.com/campaigns/sites35-f1"
        ],
        "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-12-10T10:21:33.000Z",
        "place": null,
        "communityId": null,
        "communityResults": null
      },
      {
        "id": "1998755920940245377",
        "conversationId": "1998755920940245377",
        "text": "🚨JUST IN: @humafinance and Tala Partner to Launch Scalable Tokenized Lending Platform on @Solana\n\n✍️ @ideyquickvex \nhttps://t.co/CXecPqERoQ",
        "displayTextRange": [
          0,
          139
        ],
        "author": {
          "id": "1435897632581357572",
          "username": "SolanaFloor",
          "name": "SolanaFloor",
          "bio": "Solana's #1 News Source | Powered by @StepFinance_\n\nHost of Solana's Annual Community Conference @SolanaCrossroad\n\n@SolanaFloorES 🇪🇸",
          "location": "Solana",
          "website": "https://solanafloor.com",
          "pinnedTweetIds": [
            "1999012019627049450"
          ],
          "avatar": "https://pbs.twimg.com/profile_images/1836427519836217344/kQxl-LQo_normal.png",
          "banner": "https://pbs.twimg.com/profile_banners/1435897632581357572/1763406622/1500x500",
          "profileImageShape": "Square",
          "verified": false,
          "isBlueVerified": false,
          "verifiedType": "Business",
          "verifiedSince": null,
          "isIdentityVerified": false,
          "isProtected": false,
          "possiblySensitive": false,
          "profileInterstitialType": null,
          "withheldInCountries": [],
          "professional": {
            "type": "Creator",
            "category": [],
            "restId": "1468215531295682567"
          },
          "businessAccount": null,
          "creatorSubscriptionsCount": 0,
          "hasHiddenSubscriptions": false,
          "highlightsInfo": null,
          "hasGraduatedAccess": true,
          "isProfileTranslatable": false,
          "hasCustomTimelines": true,
          "isTranslator": false,
          "affiliatesHighlightedLabel": {},
          "defaultProfile": true,
          "defaultProfileImage": false,
          "followerCount": 124825,
          "followingCount": 1594,
          "tweetCount": 22572,
          "listedCount": 1179,
          "mediaCount": 12692,
          "favoritesCount": 22347,
          "createdAt": "2021-09-09T09:27:56.000Z"
        },
        "source": null,
        "type": "tweet",
        "replyTo": null,
        "quotedTweet": null,
        "retweetedTweet": null,
        "likeCount": 98,
        "retweetCount": 12,
        "replyCount": 16,
        "quoteCount": 9,
        "bookmarkCount": 6,
        "viewCount": 8882,
        "media": [],
        "poll": null,
        "card": {
          "name": "",
          "url": "https://t.co/CXecPqERoQ",
          "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
        },
        "hashtags": [],
        "mentions": [
          {
            "id": "1504853869397905408",
            "username": "humafinance",
            "name": "Huma Finance 🟣 🇦🇪 Solana Breakpoint"
          },
          {
            "id": "951329744804392960",
            "username": "solana",
            "name": "Solana"
          },
          {
            "id": "4773716963",
            "username": "ideyquickvex",
            "name": "Pablo"
          }
        ],
        "urls": [
          "https://solanafloor.com/news/huma-finance-and-tala-partner-to-launch-scalable-tokenized-lending-platform-on-solana"
        ],
        "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-12-10T14:05:21.000Z",
        "place": null,
        "communityId": null,
        "communityResults": null
      },
      {
        "id": "1998539993883750584",
        "conversationId": "1998539993883750584",
        "text": "She is in the hopes of my previews || 2025\nMovsum x Jenni Pasanen\n↴ Link to mint page bellow ✨ https://t.co/UIm47mTBbT",
        "displayTextRange": [
          0,
          94
        ],
        "author": {
          "id": "1211646884365750272",
          "username": "PasanenJenni",
          "name": "Jenni Pasanen",
          "bio": "Multidisciplinary Artist — Digital & Traditional 🎨 \nPart of BLOOM collective ✨ \nSold @ Christies | Sotheby's | NFT 💎 \nIG jennipasanenart 📷",
          "location": "Finland",
          "website": "https://www.jennipasanen.com/newsletter",
          "pinnedTweetIds": [
            "1993430873715167330"
          ],
          "avatar": "https://pbs.twimg.com/profile_images/1539744914665250817/utAhDHr8_normal.jpg",
          "banner": "https://pbs.twimg.com/profile_banners/1211646884365750272/1719249168/1500x500",
          "profileImageShape": "Circle",
          "verified": false,
          "isBlueVerified": true,
          "verifiedType": null,
          "verifiedSince": null,
          "isIdentityVerified": false,
          "isProtected": false,
          "possiblySensitive": false,
          "profileInterstitialType": null,
          "withheldInCountries": [],
          "professional": {
            "type": "Creator",
            "category": [
              {
                "id": 1017,
                "name": "Artist",
                "icon_name": "IconBriefcaseStroke"
              }
            ],
            "restId": "1721728769021366736"
          },
          "businessAccount": null,
          "creatorSubscriptionsCount": 0,
          "hasHiddenSubscriptions": false,
          "highlightsInfo": null,
          "hasGraduatedAccess": true,
          "isProfileTranslatable": false,
          "hasCustomTimelines": true,
          "isTranslator": false,
          "affiliatesHighlightedLabel": {},
          "defaultProfile": true,
          "defaultProfileImage": false,
          "followerCount": 32702,
          "followingCount": 1981,
          "tweetCount": 48322,
          "listedCount": 437,
          "mediaCount": 4888,
          "favoritesCount": 96501,
          "createdAt": "2019-12-30T13:55:14.000Z"
        },
        "source": null,
        "type": "tweet",
        "replyTo": null,
        "quotedTweet": null,
        "retweetedTweet": null,
        "likeCount": 39,
        "retweetCount": 8,
        "replyCount": 5,
        "quoteCount": 0,
        "bookmarkCount": 2,
        "viewCount": 2272,
        "media": [
          {
            "id": "1998539823095648257",
            "key": "3_1998539823095648257",
            "type": "photo",
            "url": "https://pbs.twimg.com/media/G7w9YWEWkAEVGqd.jpg",
            "displayUrl": "pic.x.com/UIm47mTBbT",
            "expandedUrl": "https://x.com/PasanenJenni/status/1998539993883750584/photo/1",
            "thumbnailUrl": "https://pbs.twimg.com/media/G7w9YWEWkAEVGqd.jpg",
            "width": 3840,
            "height": 3840,
            "aspectRatio": [
              1,
              1
            ],
            "sizes": {
              "thumb": {
                "width": 150,
                "height": 150,
                "resize": "crop"
              },
              "small": {
                "width": 680,
                "height": 680,
                "resize": "fit"
              },
              "medium": {
                "width": 1200,
                "height": 1200,
                "resize": "fit"
              },
              "large": {
                "width": 2048,
                "height": 2048,
                "resize": "fit"
              },
              "original": {
                "width": 3840,
                "height": 3840,
                "resize": "fit"
              }
            },
            "duration": null,
            "bitrate": null,
            "videoInfo": null,
            "altText": null,
            "sensitiveMedia": false,
            "features": {
              "all": [],
              "large": [],
              "medium": [],
              "small": [],
              "orig": [
                {
                  "faces": []
                }
              ]
            },
            "mediaAvailability": {
              "status": "Available",
              "reason": null
            },
            "allowDownload": true,
            "mediaStats": null,
            "processingInfo": null,
            "sourceStatusId": null,
            "sourceUserId": null,
            "stickers": null
          }
        ],
        "poll": null,
        "card": 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-12-09T23:47:20.000Z",
        "place": null,
        "communityId": null,
        "communityResults": null
      }
    ]
  }
}

API Playground

GET/tw-v2/tweet/details-by-ids

Press ⌘ + Enter to execute

curl -X GET "https://api.tweetapi.com/tw-v2/tweet/details-by-ids" \
  -H "X-API-Key: YOUR_API_KEY"
Response

Click "Try It!" to see the response