Tweets
GET
/tw-v2/list/tweetsDescription
Retrieve tweets from a specific list. Returns a paginated timeline of tweets posted by list members.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | required | Unique list ID |
| cursor | string | optional | Pagination cursor for fetching next page of results. Obtained from previous response. |
Code Examples
const params = new URLSearchParams({
listId: '1234567890'
});
const response = await fetch(`https://api.tweetapi.com/tw-v2/list/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": "5003666593753562724",
"conversationId": "5003666593753562724",
"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": 10796,
"mediaCount": 48095,
"favoritesCount": 2077,
"createdAt": "2009-02-10T20:27:09.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": 3,
"retweetCount": 1,
"replyCount": 0,
"quoteCount": 0,
"bookmarkCount": 0,
"viewCount": 2017,
"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
},
"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
},
{
"id": "5002700188573944140",
"conversationId": "5002700188573944140",
"text": "Sample post text 61992 for documentation.",
"displayTextRange": [
0,
228
],
"author": {
"id": "1002551196",
"username": "sample_user_43386",
"name": "Sample User 43386",
"bio": "Sample profile bio for Sample User 43386.",
"location": "Sample City 457",
"website": "https://example.com/link-94089/profile-43386",
"pinnedTweetIds": [],
"avatar": "https://example.com/images/sample-avatar-43386.jpg",
"banner": "https://example.com/images/sample-banner-43386.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": "9003376833339981228"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 44695,
"followingCount": 119,
"tweetCount": 20993,
"listedCount": 346,
"mediaCount": 6810,
"favoritesCount": 3363,
"createdAt": "2014-10-28T19:12:08.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": 67,
"retweetCount": 2,
"replyCount": 4,
"quoteCount": 0,
"bookmarkCount": 4,
"viewCount": 3029,
"media": [
{
"id": "2101294277563509231",
"key": "16_2101294277563509231",
"type": "animated_gif",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-15925.jpg",
"displayUrl": "pic.x.com/Y6VkHNCcUB",
"expandedUrl": "https://x.com/sample_user_87470/status/2001653444623278148/photo/1",
"thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-36256.jpg",
"width": 300,
"height": 168,
"aspectRatio": [
25,
14
],
"sizes": {
"thumb": {
"width": 150,
"height": 150,
"resize": "crop"
},
"small": {
"width": 300,
"height": 168,
"resize": "fit"
},
"medium": {
"width": 300,
"height": 168,
"resize": "fit"
},
"large": {
"width": 300,
"height": 168,
"resize": "fit"
},
"original": {
"width": 300,
"height": 168,
"resize": "fit"
}
},
"duration": null,
"bitrate": null,
"videoInfo": {
"variants": [
{
"bitrate": 0,
"contentType": "video/mp4",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-15925.jpg"
}
],
"durationMillis": 0
},
"altText": "Interested Ooo GIF by reactionseditor",
"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-10-02T04:21:19.000Z",
"place": null,
"communityId": null,
"communityResults": null
}
],
"pagination": {
"nextCursor": "DAABCgABG2O7GFy__6EKAAIbYtF0ilZR4ggAAwAAAAIAAA",
"prevCursor": "DAABCgABG2O7GFzAJxEKAAIbY6949VfR8QgAAwAAAAEAAA"
}
}API Playground
GET
/tw-v2/list/tweetsPress ⌘ + Enter to execute
curl -X GET "https://api.tweetapi.com/tw-v2/list/tweets" \
-H "X-API-Key: YOUR_API_KEY"Response
Click "Try It!" to see the response