Details By IDs
GET
/tw-v2/tweet/details-by-idsDescription
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
| Parameter | Type | Required | Description |
|---|---|---|---|
| ids | string | required | Comma-separated list of tweet IDs to retrieve (maximum 200 IDs per request) |
Code Examples
const tweetIds = ['2002171750977445519', '2001085712943977436', '2001390983706415851'];
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": "2002171750977445519",
"conversationId": "5001695046433325839",
"text": "Sample post text 98460 for documentation.",
"displayTextRange": [
0,
278
],
"author": {
"id": "2006293925",
"username": "sample_user_85154",
"name": "Sample User 85154",
"bio": "Sample profile bio for Sample User 85154.",
"location": "Sample City 493",
"website": "https://example.com/profile-85154",
"pinnedTweetIds": [
"2005297009281584090"
],
"avatar": "https://example.com/media/sample-media-72688.jpg",
"banner": "https://example.com/media/sample-media-61934.jpg",
"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": "2001309288299939786"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {
"label": {
"url": {
"url": "https://example.com/link-94089/profile-41921/Sample description for documentation 49447._Finance",
"urlType": "DeepLink"
},
"badge": {
"url": "https://example.com/media/sample-media-85061.jpg"
},
"description": "Sample description for documentation 49447.",
"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,
"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": 55,
"retweetCount": 0,
"replyCount": 20,
"quoteCount": 1,
"bookmarkCount": 2,
"viewCount": 2615,
"media": [
{
"id": "2001167493280852678",
"key": "13_2001167493280852678",
"type": "video",
"url": "https://example.com/media/sample-media-41049.jpg",
"displayUrl": "pic.x.com/H8tUFQMiIM",
"expandedUrl": "https://x.com/sample_user_88784/status/2005293125405946889/video/1",
"thumbnailUrl": "https://example.com/media/sample-media-68973.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://example.com/media/sample-media-37488.jpg"
},
{
"bitrate": 632000,
"contentType": "video/mp4",
"url": "https://example.com/media/sample-media-89684.jpg"
},
{
"bitrate": 950000,
"contentType": "video/mp4",
"url": "https://example.com/media/sample-media-97684.jpg"
},
{
"bitrate": 2176000,
"contentType": "video/mp4",
"url": "https://example.com/media/sample-media-19761.jpg"
},
{
"bitrate": 10368000,
"contentType": "video/mp4",
"url": "https://example.com/media/sample-media-28268.jpg"
},
{
"bitrate": 25128000,
"contentType": "video/mp4",
"url": "https://example.com/media/sample-media-41049.jpg"
}
],
"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": "2003777419665913692",
"key": "3_2003777419665913692",
"type": "photo",
"url": "https://example.com/media/sample-media-35656.jpg",
"displayUrl": "pic.x.com/H8tUFQMiIM",
"expandedUrl": "https://x.com/sample_user_88784/status/2005293125405946889/video/1",
"thumbnailUrl": "https://example.com/media/sample-media-35656.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": "sample_user_15900",
"username": "sample_user_08227",
"name": "sample_user_08227"
}
],
"urls": [
"https://example.com/link-81824"
],
"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": "2001085712943977436",
"conversationId": "5005342409944857687",
"text": "Sample post text 21266 for documentation.",
"displayTextRange": [
0,
139
],
"author": {
"id": "2001247918698523627",
"username": "sample_user_72184",
"name": "Sample User 72184",
"bio": "Sample profile bio for Sample User 72184.",
"location": "Sample City 866",
"website": "https://example.com/profile-72184",
"pinnedTweetIds": [
"2001188189926834188"
],
"avatar": "https://example.com/media/sample-media-90390.jpg",
"banner": "https://example.com/media/sample-media-96122.jpg",
"profileImageShape": "Square",
"verified": false,
"isBlueVerified": false,
"verifiedType": "Business",
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "2001358049460435192"
},
"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,
"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": 98,
"retweetCount": 12,
"replyCount": 16,
"quoteCount": 9,
"bookmarkCount": 6,
"viewCount": 8882,
"media": [],
"poll": null,
"card": {
"name": "",
"url": "https://example.com/link-20541",
"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": "sample_user_92809",
"username": "sample_user_00158",
"name": "sample_user_77867"
},
{
"id": "sample_user_30053",
"username": "sample_user_48375",
"name": "sample_user_13556"
},
{
"id": "sample_user_35864",
"username": "sample_user_54210",
"name": "sample_user_80395"
}
],
"urls": [
"https://example.com/link-59221"
],
"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": "2001390983706415851",
"conversationId": "5001231875823925520",
"text": "Sample post text 69284 for documentation.",
"displayTextRange": [
0,
94
],
"author": {
"id": "2003402457649470437",
"username": "sample_user_05168",
"name": "Sample User 05168",
"bio": "Sample profile bio for Sample User 05168.",
"location": "Sample City 514",
"website": "https://example.com/profile-05168",
"pinnedTweetIds": [
"2009454311581706694"
],
"avatar": "https://example.com/media/sample-media-52576.jpg",
"banner": "https://example.com/media/sample-media-14687.jpg",
"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": "2001318225778387894"
},
"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,
"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": 39,
"retweetCount": 8,
"replyCount": 5,
"quoteCount": 0,
"bookmarkCount": 2,
"viewCount": 2272,
"media": [
{
"id": "2001186783151650313",
"key": "3_2001186783151650313",
"type": "photo",
"url": "https://example.com/media/sample-media-18269.jpg",
"displayUrl": "pic.x.com/UIm47mTBbT",
"expandedUrl": "https://x.com/sample_user_73643/status/2001418803130766099/photo/1",
"thumbnailUrl": "https://example.com/media/sample-media-18269.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-idsPress ⌘ + 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