Tweets
GET
/tw-v2/community/tweetsDescription
Retrieve tweets from a specific community. Returns a paginated timeline of community tweets with configurable sorting.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| communityId | string | required | Unique community ID |
| cursor | string | optional | Pagination cursor for fetching next page of results. Obtained from previous response. |
| sortBy | string | optional | Optional sort order for results (Relevance, Recency). Defaults to Relevance. |
Code Examples
const params = new URLSearchParams({
communityId: '1234567890',
sortBy: 'Relevance'
});
const response = await fetch(`https://api.tweetapi.com/tw-v2/community/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": "5006667037470870963",
"conversationId": "5006667037470870963",
"text": "Sample post text 36780 for documentation.",
"displayTextRange": [
0,
23
],
"author": {
"id": "1001803218216296533",
"username": "sample_user_57219",
"name": "Sample User 57219",
"bio": "Sample profile bio for Sample User 57219.",
"location": "Sample City 343",
"website": null,
"pinnedTweetIds": [
"2001722005987525364"
],
"avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-55473.jpg",
"banner": "https://example.com/link-94089/profile-29900/images/sample-banner-55473.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": "7005089460967755889"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": false,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 6365,
"followingCount": 1393,
"tweetCount": 791,
"listedCount": 17,
"mediaCount": 471,
"favoritesCount": 1492,
"createdAt": "2021-02-21T06:26:16.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": 264,
"retweetCount": 31,
"replyCount": 10,
"quoteCount": 12,
"bookmarkCount": 42,
"viewCount": 96574,
"media": [
{
"id": "2101746875490153094",
"key": "13_2101746875490153094",
"type": "video",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-20997.jpg",
"displayUrl": "pic.x.com/QIdAtAgDh8",
"expandedUrl": "https://x.com/sample_user_24419/status/2006047531480951464/video/1",
"thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-77164.jpg",
"width": 718,
"height": 1008,
"aspectRatio": [
359,
504
],
"sizes": {
"thumb": {
"width": 150,
"height": 150,
"resize": "crop"
},
"small": {
"width": 484,
"height": 680,
"resize": "fit"
},
"medium": {
"width": 718,
"height": 1008,
"resize": "fit"
},
"large": {
"width": 718,
"height": 1008,
"resize": "fit"
},
"original": {
"width": 718,
"height": 1008,
"resize": "fit"
}
},
"duration": 6,
"bitrate": null,
"videoInfo": {
"variants": [
{
"bitrate": 0,
"contentType": "application/x-mpegURL",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-83584.jpg"
},
{
"bitrate": 632000,
"contentType": "video/mp4",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-03082.jpg"
},
{
"bitrate": 950000,
"contentType": "video/mp4",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-21962.jpg"
},
{
"bitrate": 2176000,
"contentType": "video/mp4",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-20997.jpg"
}
],
"durationMillis": 6266
},
"altText": null,
"sensitiveMedia": false,
"features": {
"all": [],
"large": [],
"medium": [],
"small": [],
"orig": [
{
"faces": []
}
]
},
"mediaAvailability": {
"status": "Available",
"reason": null
},
"allowDownload": true,
"mediaStats": null,
"processingInfo": null,
"sourceStatusId": "2004323655856908632",
"sourceUserId": "2107850470394562381",
"stickers": null
}
],
"poll": null,
"card": null,
"hashtags": [],
"mentions": [],
"urls": [],
"symbols": [],
"possiblySensitive": false,
"limitedActions": null,
"isEdited": false,
"editControl": null,
"isTranslatable": false,
"lang": "zxx",
"translatedText": null,
"hasBirdwatchNotes": false,
"birdwatchPivot": null,
"conversationControl": null,
"isPromoted": false,
"promotedMetadata": null,
"createdAt": "2025-09-30T17:38:50.000Z",
"place": null,
"communityId": null,
"communityResults": null
},
{
"id": "5009832845589304885",
"conversationId": "5009832845589304885",
"text": "Sample post text 74039 for documentation.",
"displayTextRange": [
0,
96
],
"author": {
"id": "1003588989524708874",
"username": "sample_user_79306",
"name": "Sample User 79306",
"bio": "Sample profile bio for Sample User 79306.",
"location": null,
"website": null,
"pinnedTweetIds": [
"2001534739851947993"
],
"avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-14221.jpg",
"banner": "https://example.com/link-94089/profile-29900/images/sample-banner-14221.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": false,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 4021,
"followingCount": 4282,
"tweetCount": 26814,
"listedCount": 11,
"mediaCount": 1229,
"favoritesCount": 26174,
"createdAt": "2024-10-02T15:59:52.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": 8,
"retweetCount": 0,
"replyCount": 8,
"quoteCount": 0,
"bookmarkCount": 0,
"viewCount": 57,
"media": [
{
"id": "2101088986934120067",
"key": "3_2101088986934120067",
"type": "photo",
"url": "https://example.com/link-94089/profile-29900/media/sample-media-95515.jpg",
"displayUrl": "pic.x.com/z03r2zwKpw",
"expandedUrl": "https://x.com/sample_user_78186/status/2004781308872389299/photo/1",
"thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-95515.jpg",
"width": 915,
"height": 637,
"aspectRatio": [
915,
637
],
"sizes": {
"thumb": {
"width": 150,
"height": 150,
"resize": "crop"
},
"small": {
"width": 680,
"height": 473,
"resize": "fit"
},
"medium": {
"width": 915,
"height": 637,
"resize": "fit"
},
"large": {
"width": 915,
"height": 637,
"resize": "fit"
},
"original": {
"width": 915,
"height": 637,
"resize": "fit"
}
},
"duration": null,
"bitrate": null,
"videoInfo": null,
"altText": null,
"sensitiveMedia": false,
"features": {
"all": [],
"large": [],
"medium": [],
"small": [],
"orig": [
{
"faces": [
{
"x": 0,
"y": 0,
"width": 915,
"height": 512
},
{
"x": 116,
"y": 0,
"width": 637,
"height": 637
},
{
"x": 155,
"y": 0,
"width": 559,
"height": 637
},
{
"x": 275,
"y": 0,
"width": 319,
"height": 637
},
{
"x": 0,
"y": 0,
"width": 915,
"height": 637
}
]
}
]
},
"mediaAvailability": {
"status": "Available",
"reason": null
},
"allowDownload": true,
"mediaStats": null,
"processingInfo": null,
"sourceStatusId": null,
"sourceUserId": null,
"stickers": null
}
],
"poll": null,
"card": null,
"hashtags": [],
"mentions": [
"sample_user_79992",
"sample_user_88713"
],
"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-02T03:15:17.000Z",
"place": null,
"communityId": null,
"communityResults": null
}
],
"pagination": {
"nextCursor": "DAABCgABG2O7RcJ__-kKAAIbYrso_1sA1ggAAwAAAAIAAA",
"prevCursor": "DAABCgABG2O7RcKAJxEKAAIbY5du5xohyggAAwAAAAEAAA"
}
}API Playground
GET
/tw-v2/community/tweetsPress ⌘ + Enter to execute
curl -X GET "https://api.tweetapi.com/tw-v2/community/tweets" \
-H "X-API-Key: YOUR_API_KEY"Response
Click "Try It!" to see the response