Lists

List tweets

Tweets from a list timeline, with cursor pagination.

GET/api/v1/twitter/lists/:listId/tweets

Price

3–7 tokens per successful call. 2 + 1 × ceil(count ÷ 20). Failed calls are refunded; a 404 is charged.

Parameters

listIdpathrequired: List ID. Example: 1580661677227986944
countquery: Items to return, 1–100. Default 20. Example: 20
cursorquery: Cursor from a previous response's next field.

Request

curl

curl "https://api.xscraper.online/api/v1/twitter/lists/1580661677227986944/tweets?count=20" \
  -H "x-api-key: $XSCRAPER_KEY"

Response

200 OK (example shape)

{
  "success": true,
  "message": "…",
  "data": {
    "tweets": [
      {
        "id": "2019881223666233717",
        "text": "Officially launching X API Pay-Per-Use …",
        "html": "Officially launching X API Pay-Per-Use …",
        "userId": "2244994945",
        "username": "XDevelopers",
        "name": "Developers",
        "permanentUrl": "https://x.com/XDevelopers/status/2019881223666233717",
        "conversationId": "2019881223666233717",
        "timeParsed": "2026-02-06T21:09:45.000Z",
        "timestamp": 1770412185,
        "likes": 5589,
        "retweets": 908,
        "replies": 795,
        "quoteCount": 593,
        "bookmarkCount": 2804,
        "views": 2544772,
        "lang": "en",
        "source": "Twitter Web App",
        "hashtags": [],
        "cashtags": [],
        "mentions": [],
        "urls": [
          "http://developer.x.com"
        ],
        "links": [
          {
            "url": "http://developer.x.com",
            "displayUrl": "developer.x.com"
          }
        ],
        "photos": [],
        "videos": [],
        "media": [
          {
            "id": "1585341912877146112",
            "type": "video",
            "url": "https://pbs.twimg.com/ext_tw_video_thumb/1585341912877146112/pu/img/DwJ7wlGIe9iryk6N.jpg",
            "altText": null,
            "width": 1920,
            "height": 1080,
            "durationMs": 9301,
            "variants": [
              {
                "url": "https://video.twimg.com/…/1920x1080/….mp4",
                "contentType": "video/mp4",
                "bitrate": 10368000
              },
              {
                "url": "https://video.twimg.com/…/1280x720/….mp4",
                "contentType": "video/mp4",
                "bitrate": 2176000
              },
              {
                "url": "https://video.twimg.com/…/pl/….m3u8",
                "contentType": "application/x-mpegURL",
                "bitrate": null
              }
            ]
          }
        ],
        "card": {
          "name": "summary_large_image",
          "url": "https://t.co/FS66GuIYJD",
          "title": "X Developer Platform",
          "description": "Use the X API with an all-new Developer Console and consumption-based billing.",
          "domain": "developer.x.com",
          "image": "https://pbs.twimg.com/card_img/2100194922750230528/E7alxN6C?format=jpg&name=orig"
        },
        "author": {
          "userId": "2244994945",
          "username": "XDevelopers",
          "name": "Developers",
          "avatar": "https://pbs.twimg.com/profile_images/1683501992314798080/xl1POYLw.jpg",
          "isBlueVerified": true,
          "verifiedType": "Business",
          "isPrivate": false,
          "followersCount": 698112,
          "followingCount": 765,
          "affiliation": {
            "label": "X",
            "url": "https://twitter.com/X",
            "badgeUrl": "https://pbs.twimg.com/profile_images/…"
          }
        },
        "isQuoted": false,
        "isReply": false,
        "isRetweet": false,
        "isPin": true,
        "isEdited": false,
        "versions": [
          "2019881223666233717"
        ],
        "sensitiveContent": false,
        "inReplyToUserId": null,
        "inReplyToUsername": null,
        "thread": []
      }
    ],
    "next": "DAACCgACGZ…"
  },
  "errors": null
}