Tweets
GET
/tw-v2/user/tweetsDescription
Retrieve tweets posted by a specific user. Returns a paginated timeline of original tweets (no replies).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| userId | string | required | Unique platform user ID (e.g., '10017528') |
| cursor | string | optional | Pagination cursor for fetching next page of results. Obtained from previous response. |
Code Examples
const params = new URLSearchParams({
userId: '10017528'
});
const response = await fetch(`https://api.tweetapi.com/tw-v2/user/tweets?${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": [
{
"id": "5001591756625130239",
"conversationId": "5001591756625130239",
"text": "Sample post text 83969 for documentation.",
"displayTextRange": [
0,
140
],
"author": {
"id": "10017528",
"username": "sample_user_96991",
"name": "Sample User 96991",
"bio": "Sample profile bio for Sample User 96991.",
"location": null,
"website": null,
"pinnedTweetIds": [
"2003874737416606947"
],
"avatar": "https://example.com/images/sample-avatar-96991.jpg",
"banner": "https://example.com/images/sample-banner-96991.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "9009505976599913053"
},
"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/X",
"urlType": "DeepLink"
},
"badge": {
"url": "https://example.com/link-94089/profile-29900/media/sample-media-25883.jpg"
},
"description": "Sample description for documentation 11871.",
"userLabelType": "BusinessLabel",
"userLabelDisplayType": "Badge"
}
},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 226995942,
"followingCount": 1218,
"tweetCount": 86746,
"listedCount": 164447,
"mediaCount": 4162,
"favoritesCount": 174839,
"createdAt": "2009-06-02T20:12:29.000Z"
},
"source": null,
"type": "retweet",
"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": 0,
"retweetCount": 308,
"replyCount": 0,
"quoteCount": 0,
"bookmarkCount": 0,
"viewCount": 0,
"media": [],
"poll": null,
"card": null,
"hashtags": [],
"mentions": [
"sample_user_18760",
"sample_user_26437"
],
"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-02T05:47:48.000Z",
"place": null,
"communityId": null,
"communityResults": null
},
{
"id": "5008764432791373827",
"conversationId": "5008764432791373827",
"text": "Sample post text 05861 for documentation.",
"displayTextRange": [
0,
14
],
"author": {
"id": "10017528",
"username": "sample_user_96991",
"name": "Sample User 96991",
"bio": "Sample profile bio for Sample User 96991.",
"location": null,
"website": null,
"pinnedTweetIds": [
"2003874737416606947"
],
"avatar": "https://example.com/images/sample-avatar-96991.jpg",
"banner": "https://example.com/images/sample-banner-96991.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "9009505976599913053"
},
"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/X",
"urlType": "DeepLink"
},
"badge": {
"url": "https://example.com/link-94089/profile-29900/media/sample-media-25883.jpg"
},
"description": "Sample description for documentation 11871.",
"userLabelType": "BusinessLabel",
"userLabelDisplayType": "Badge"
}
},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 226995942,
"followingCount": 1218,
"tweetCount": 86746,
"listedCount": 164447,
"mediaCount": 4162,
"favoritesCount": 174839,
"createdAt": "2009-06-02T20:12:29.000Z"
},
"source": null,
"type": "quote",
"replyTo": null,
"quotedTweet": {
"id": "5001326762730364257",
"conversationId": "5001326762730364257",
"text": "Sample post text 87993 for documentation.",
"displayTextRange": [
0,
4
],
"author": {
"id": "10051246",
"username": "sample_user_35585",
"name": "Sample User 35585",
"bio": "Sample profile bio for Sample User 35585.",
"location": "Sample City 147",
"website": null,
"pinnedTweetIds": [
"2001184043341139638"
],
"avatar": "https://example.com/images/sample-avatar-35585.jpg",
"banner": "https://example.com/images/sample-banner-35585.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": null,
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 672408,
"followingCount": 3478,
"tweetCount": 267584,
"listedCount": 4978,
"mediaCount": 15841,
"favoritesCount": 96203,
"createdAt": "2007-06-25T21:03:36.000Z"
},
"source": null,
"type": "quote",
"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": 6504,
"retweetCount": 493,
"replyCount": 303,
"quoteCount": 2,
"bookmarkCount": 259,
"viewCount": 13373944,
"media": [
{
"id": "2001542505607599289",
"key": "3_2001542505607599289",
"type": "photo",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-82570.jpg",
"displayUrl": "pic.x.com/IZ6RBzsBAa",
"expandedUrl": "https://x.com/sample_user_14641/status/2009988722539212593/photo/1",
"thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-82570.jpg",
"width": 631,
"height": 664,
"aspectRatio": [
631,
664
],
"sizes": {
"thumb": {
"width": 150,
"height": 150,
"resize": "crop"
},
"small": {
"width": 631,
"height": 664,
"resize": "fit"
},
"medium": {
"width": 631,
"height": 664,
"resize": "fit"
},
"large": {
"width": 631,
"height": 664,
"resize": "fit"
},
"original": {
"width": 631,
"height": 664,
"resize": "fit"
}
},
"duration": null,
"bitrate": null,
"videoInfo": null,
"altText": null,
"sensitiveMedia": false,
"features": {
"all": [],
"large": [],
"medium": [],
"small": [],
"orig": [
{
"faces": [
{
"x": 0,
"y": 239,
"width": 631,
"height": 353
},
{
"x": 0,
"y": 33,
"width": 631,
"height": 631
},
{
"x": 0,
"y": 0,
"width": 582,
"height": 664
},
{
"x": 0,
"y": 0,
"width": 332,
"height": 664
},
{
"x": 0,
"y": 0,
"width": 631,
"height": 664
}
]
}
]
},
"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-10-01T23:59:45.000Z",
"place": null,
"communityId": null,
"communityResults": 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": 133058,
"retweetCount": 12364,
"replyCount": 8555,
"quoteCount": 838,
"bookmarkCount": 2775,
"viewCount": 13154390,
"media": [],
"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-10-02T02:42:03.000Z",
"place": null,
"communityId": null,
"communityResults": null
}
],
"pagination": {
"nextCursor": "DAAHCgABG2O6blp__-sLAAIAAAATMTk3MzQ5NjkzNDM4MDk5OTA3OQgAAwAAAAIAAA",
"prevCursor": "DAAHCgABG2O6blqAJxELAAIAAAATMTk3MzYyNTk0NTQ4MDQyOTYwMggAAwAAAAEAAA"
}
}API Playground
GET
/tw-v2/user/tweetsPress ⌘ + Enter to execute
curl -X GET "https://api.tweetapi.com/tw-v2/user/tweets" \
-H "X-API-Key: YOUR_API_KEY"Response
Click "Try It!" to see the response