xAPIs.dev
API Reference · v2
Free Tools{ }OpenAPI YAMLGet API key
API Reference / List / Get list tweets

Get list tweets

GET/twitter/list/tweets15 credits

Fetch tweets posted to a Twitter List. Cursor-paginated. The sample response below is captured from the live API. List endpoints paginate with `has_next_page` and `next_cursor`.

Authentication required
Send your key in the x-api-key header. Requests without a valid key return 401.

Query parameters

listId
stringrequired
The numeric ID of the list.
cursor
stringoptional
Pagination cursor for the next page.

Response fields

tweetsarray
Array of tweet objects with engagement metrics and author info.
has_next_pageboolean
Whether another page of results is available.
next_cursorstring
Cursor for the next page; null or empty when exhausted.
statusstring
Request status: "success" or "error".
msgstring
Status message from the upstream.
Request
curl https://v2.xapis.dev/twitter/list/tweets \
  -G --data-urlencode "listId=2073422513296822490" \
  -H "x-api-key: $XAPIS_KEY"
Response200 OK
application/json
{
  "tweets": [
    {
      "type": "tweet",
      "id": "2074776753483248065",
      "url": "https://x.com/sumeragi_0o/status/2074776753483248065",
      "twitterUrl": "https://twitter.com/sumeragi_0o/status/2074776753483248065",
      "text": "本日配信 https://t.co/uWi3OuObzH",
      "source": "Twitter for iPhone",
      "retweetCount": 113,
      "replyCount": 44,
      "likeCount": 552,
      "quoteCount": 9,
      "viewCount": 6484,
      "createdAt": "Wed Jul 08 08:45:00 +0000 2026",
      "lang": "ja",
      "bookmarkCount": 4,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2074776753483248065",
      "displayTextRange": [
        0
      ],
      "inReplyToUserId": null,
      "inReplyToUsername": null,
      "author": {
        "type": "user",
        "userName": "sumeragi_0o",
        "url": "https://x.com/sumeragi_0o",
        "twitterUrl": "https://twitter.com/sumeragi_0o",
        "id": "1962434307949297665",
        "name": "皇れお👑🌸にじさんじ",
        "isVerified": false,
        "isBlueVerified": false,
        "verifiedType": null,
        "profilePicture": "https://pbs.twimg.com/profile_images/2039332726357266432/CtLf2b-j_normal.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/1962434307949297665/1775015717",
        "description": "",
        "location": "ほしの学園 ダンス部",
        "followers": 92977,
        "following": 210,
        "status": "",
        "canDm": false,
        "canMediaTag": false,
        "createdAt": "Mon Sep 01 08:36:58 +0000 2025",
        "entities": {
          "description": "…",
          "url": "…"
        },
        "fastFollowersCount": 0,
        "favouritesCount": 10669,
        "hasCustomTimelines": true,
        "isTranslator": false,
        "…": "…"
      },
      "extendedEntities": {
        "media": [
          "…"
        ]
      },
      "card": null,
      "place": {},
      "…": "…"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABHMsWdvObccEKAAIcys6ZEVrwpQAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUcyxi9MYAnEAoABhzLGL0xf9jwAAA",
  "status": "success",
  "msg": "success"
}
base url · https://v2.xapis.dev
Ready to call Get list tweets?