Skip to content
Browse the docs

Tweets

User tweets

Most recent tweets from a user, newest first.

GET/api/v1/twitter/users/tweets/:username

Price

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

Parameters

usernamepathrequired
Screen name without the @. Example: elonmusk
countquery
Items to return, 1–100. Default 5. Example: 5

Request

curl
curl "https://api.xscraper.online/api/v1/twitter/users/tweets/elonmusk?count=5" \
  -H "x-api-key: $XSCRAPER_KEY"

Response

200 OK (example shape)
{
  "success": true,
  "message": "…",
  "data": [
    {
      "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": []
    }
  ],
  "errors": null
}

Try it

Estimated cost 3 tokens

Kept in this tab only and sent only as the x-api-key header of this request.

Screen name without the @.

Items to return, 1–100. Default 5.

GET /api/v1/twitter/users/tweets/elonmusk?count=5

The response, its status and the tokens it cost appear here.