TweetAPI

Tweets

GET/tw-v2/list/tweets

Description

Retrieve tweets from a specific Twitter list. Returns a paginated timeline of tweets posted by list members.

Parameters

ParameterTypeRequiredDescription
listIdstringrequiredUnique Twitter list ID
cursorstringoptionalPagination 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": "1973613995765518833",
      "conversationId": "1973613995765518833",
      "text": "Lowest price ever: Apple Watch SE 2 (GPS + Cellular) plunges to $189 https://t.co/rRVwqYFCYS #Apple",
      "displayTextRange": [
        0,
        99
      ],
      "author": {
        "id": "20542450",
        "username": "appleinsider",
        "name": "AppleInsider",
        "bio": "In-depth Apple news, analysis & reviews since 1997.",
        "location": "Cupertino, California",
        "website": "https://appleinsider.com",
        "pinnedTweetIds": [
          "1757293782838419554"
        ],
        "avatar": "https://pbs.twimg.com/profile_images/563064706462535680/h1p6ZJ7V_400x400.jpeg",
        "banner": "https://pbs.twimg.com/profile_banners/20542450/1436810030/1500x500",
        "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": "1649144731941601280"
        },
        "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,
      "likeCount": 3,
      "retweetCount": 1,
      "replyCount": 0,
      "quoteCount": 0,
      "bookmarkCount": 0,
      "viewCount": 2017,
      "media": [],
      "poll": null,
      "card": {
        "name": "",
        "url": "https://t.co/rRVwqYFCYS",
        "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": [
        "Apple"
      ],
      "mentions": [],
      "urls": [
        "https://appleinsider.com/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": "1973604181530517783",
      "conversationId": "1973604181530517783",
      "text": "Elon: Cancel Netflix it’s woke\n\nOk I’ll watch Disney+\n\nElon: no that’s woke too\n\nOk… so maybe Prime?\n\nElon: No screw Bezos\n\nSo what should I watch?\n\nElon: idk subscribe to Premium Plus Pro for $40 a month and talk to my AI girls https://t.co/Y6VkHNCcUB",
      "displayTextRange": [
        0,
        228
      ],
      "author": {
        "id": "2881142534",
        "username": "TailosiveTech",
        "name": "Tailosive Tech",
        "bio": "I like when tech just works",
        "location": "United States",
        "website": "http://youtube.com/TailosiveTech",
        "pinnedTweetIds": [],
        "avatar": "https://pbs.twimg.com/profile_images/1741731607625834496/_bl3Nkai_400x400.jpg",
        "banner": "https://pbs.twimg.com/profile_banners/2881142534/1707187028/1500x500",
        "profileImageShape": "Circle",
        "verified": false,
        "isBlueVerified": true,
        "verifiedType": null,
        "verifiedSince": null,
        "isIdentityVerified": false,
        "isProtected": false,
        "possiblySensitive": false,
        "profileInterstitialType": null,
        "withheldInCountries": [],
        "professional": {
          "type": "Creator",
          "category": [],
          "restId": "1679200791813554177"
        },
        "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,
      "likeCount": 67,
      "retweetCount": 2,
      "replyCount": 4,
      "quoteCount": 0,
      "bookmarkCount": 4,
      "viewCount": 3029,
      "media": [
        {
          "id": "1973604175843074048",
          "key": "16_1973604175843074048",
          "type": "animated_gif",
          "url": "https://video.twimg.com/tweet_video/G2OmipRaoAAdyPf.mp4",
          "displayUrl": "pic.x.com/Y6VkHNCcUB",
          "expandedUrl": "https://x.com/TailosiveTech/status/1973604181530517783/photo/1",
          "thumbnailUrl": "https://pbs.twimg.com/tweet_video_thumb/G2OmipRaoAAdyPf.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://video.twimg.com/tweet_video/G2OmipRaoAAdyPf.mp4"
              }
            ],
            "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/tweets

Press ⌘ + 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