X Timeline Scraper

GET/v1/x/users/{handle}/tweets

MCPx_tweets3 creditsLive

Updated Oct 14, 2026

Description

Get an X account's recent tweets, newest first, with likes, retweets, replies, views and media. Costs 3 credits per page of about 20 tweets. Tip: set includeRetweets=false to see only what the account wrote itself.

Parameters

Name	In	Type	Required	Default	Description
`handle`	path	string	yes		Handle with or without @, or a profile URL. 1-15 characters.
`includeRetweets`	query	boolean,string	no		When false, only tweets the account wrote itself.
`limit`	query	integer	no	`20`	Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100.
`cursor`	query	string	no		Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

handle path, string, required: Handle with or without @, or a profile URL. 1-15 characters.
includeRetweets query, boolean,string: When false, only tweets the account wrote itself.
limit query, integer: Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page. Range 1 to 100. Default 20.
cursor query, string: Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

Request examples

curl "https://chatterapi.com/v1/x/users/levelsio/tweets" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is a list of XTweet, with page.nextCursor and page.hasMore for the next page. Fields:

Field	Type	Nullable	Description
`id`	string	no	Platform id.
`text`	string	no	Text.
`url`	string	no	Full URL on the platform.
`createdAt`	string	yes	ISO 8601 UTC timestamp.
`lang`	string	yes	Language code.
`likes`	number	yes	Likes.
`retweets`	number	yes	Retweets.
`replies`	number	yes	Replies.
`quotes`	number	yes	Quote tweets.
`views`	number	yes	Views.
`bookmarks`	number	yes	Bookmarks.
`isReply`	boolean	no	Is a reply.
`inReplyToId`	string	yes	Tweet this replies to.
`conversationId`	string	yes	Root tweet id of the conversation.
`isRetweet`	boolean	no	Is a retweet.
`quotedTweetId`	string	yes	Tweet this quotes.
`author`	object	no	Author profile (XUser).
`media`	object[]	no	Images, video or gallery URLs, or null.

response

{
  "data": [
    {
      "id": "2110066474513793361",
      "text": "✨ 200,000+ users on my computer nostalgia project @pieter\n\nSometimes it takes a few years for things to take off, in this case about 2 years!\n\nKeep creating 💖 https://t.co/Na0LXnwAjW",
      "url": "https://x.com/levelsio/status/2110066474513793361",
      "createdAt": "2026-10-13T17:53:45.000Z",
      "lang": "en",
      "likes": 129,
      "retweets": 4,
      "replies": 37,
      "quotes": 0,
      "views": 15475,
      "bookmarks": 9,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2110066474513793361",
      "isRetweet": false,
      "quotedTweetId": "2108957488410161442",
      "author": {
        "id": "1577241403",
        "handle": "levelsio",
        "name": "@levelsio",
        "bio": "💸https://t.co/sQ0aiU7v02\n📸https://t.co/lAyoqmSBRX $86K/m\n🎮https://t.co/tF49atJ396 $44K/m\n🏡https://t.co/1oqUgfD6CZ $23K/m\n👙@X $13K/m\n🌍https://t.co/UXK5AFqCaQ $7K/m\n🏩https://t.co/4p4dzTDVN6 $5K/m",
        "followers": 974778,
        "following": 3275,
        "tweets": null,
        "verified": false,
        "blueVerified": true,
        "canDm": false,
        "protected": null,
        "location": "📕My book $5K/m 👉",
        "url": null,
        "avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_normal.jpg",
        "createdAt": "2013-07-08T09:31:59.000Z"
      },
      "media": [
        {
          "type": "photo",
          "url": "https://pbs.twimg.com/media/HUh2NAYWQAAP7ZK.jpg"
        }
      ]
    },
    {
      "id": "2110030627336540370",
      "text": "This is also interesting to think about\n\nRight now it still takes, let's say, 30 minutes to a few hours to build something usable with AI and then you still polish for days/weeks/months\n\nIf we assume this will keep getting faster, at some point an AI model will take a second or less to generate the whole thing\n\nImagine a future where you can create anything in less than second?\n\nHow will that change what we choose to create? Will humans even create, or will it all be AI agents coming up with ideas themselves?\n\nThe next constraints then become physical? If AI can generate for example hardware plans so fast, it will still take 30 minutes to 3d print that, so maybe the next speed and intelligence optimizations will then start happening in hardware, being able to generate an idea and producing a physical object in a minute or so\n\nI have no idea but very interesting, it's kinda like those real-time video models we saw last month (like my Infinite Slop project), how will content change if you can generate so fast?\n\n🤔",
      "url": "https://x.com/levelsio/status/2110030627336540370",
      "createdAt": "2026-10-13T15:31:18.000Z",
      "lang": "en",
      "likes": 324,
      "retweets": 11,
      "replies": 112,
      "quotes": 10,
      "views": 38339,
      "bookmarks": 118,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2110030627336540370",
      "isRetweet": false,
      "quotedTweetId": null,
      "author": {
        "id": "1577241403",
        "handle": "levelsio",
        "name": "@levelsio",
        "bio": "💸https://t.co/sQ0aiU7v02\n📸https://t.co/lAyoqmSBRX $86K/m\n🎮https://t.co/tF49atJ396 $44K/m\n🏡https://t.co/1oqUgfD6CZ $23K/m\n👙@X $13K/m\n🌍https://t.co/UXK5AFqCaQ $7K/m\n🏩https://t.co/4p4dzTDVN6 $5K/m",
        "followers": 974778,
        "following": 3275,
        "tweets": null,
        "verified": false,
        "blueVerified": true,
        "canDm": false,
        "protected": null,
        "location": "📕My book $5K/m 👉",
        "url": null,
        "avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_normal.jpg",
        "createdAt": "2013-07-08T09:31:59.000Z"
      },
      "media": []
    },
    {
      "id": "2110010323633590433",
      "text": "Swarms of historically accurate AI personalities from 2006 from different countries that you have conversations with",
      "url": "https://x.com/levelsio/status/2110010323633590433",
      "createdAt": "2026-10-13T14:10:37.000Z",
      "lang": "en",
      "likes": 46,
      "retweets": 0,
      "replies": 16,
      "quotes": 0,
      "views": 20859,
      "bookmarks": 9,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2110010323633590433",
      "isRetweet": false,
      "quotedTweetId": "2110006128746618903",
      "author": {
        "id": "1577241403",
        "handle": "levelsio",
        "name": "@levelsio",
        "bio": "💸https://t.co/sQ0aiU7v02\n📸https://t.co/lAyoqmSBRX $86K/m\n🎮https://t.co/tF49atJ396 $44K/m\n🏡https://t.co/1oqUgfD6CZ $23K/m\n👙@X $13K/m\n🌍https://t.co/UXK5AFqCaQ $7K/m\n🏩https://t.co/4p4dzTDVN6 $5K/m",
        "followers": 974778,
        "following": 3275,
        "tweets": null,
        "verified": false,
        "blueVerified": true,
        "canDm": false,
        "protected": null,
        "location": "📕My book $5K/m 👉",
        "url": null,
        "avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_normal.jpg",
        "createdAt": "2013-07-08T09:31:59.000Z"
      },
      "media": []
    }
  ],
  "page": {
    "nextCursor": "eyJ2IjoxLCJwIjoiZ2V0eGFwaSIsImMiOiJEQUFIQ2dBQkhVaVU1MEtfXy00TEFBSUFBQUFUTWpFd09UWTBPVGd5T0RrNE1EVTVNalkyT1FnQUF3QUFBQUlBQUEiLCJvIjowLCJoIjoiNWUzYzM5ZWFjZTc1In0",
    "hasMore": true
  },
  "credits": {
    "charged": 3,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-14, truncated to 3 items. Credits and request id are illustrative.

Credits

3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.

Errors this tool can return

Try it

Try in the playground Run it free without signup