Skip to main content
GET
/
x
/
user-timeline
curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk" \
  -H "x-api-key: YOUR_API_KEY"

{
  "tweets": [
    {
      "id": "1858123456789012345",
      "text": "Example post content",
      "author": {
        "username": "elonmusk",
        "name": "Elon Musk"
      },
      "createdAt": "2026-06-11T18:24:00.000Z"
    }
  ],
  "nextCursor": "DAABCgABGc7hF0lAAAAACgACGc..."
}
Returns the most recent posts authored by an X account (up to 20 per page). Retweets are excluded — only the account’s own posts are returned. Each entry is a fully hydrated tweet payload, identical in shape to the Post Data response.
This endpoint is rate-limited to 10 requests per 60 seconds.

​
Query Parameters

​
username
string
required
The X username (handle) to fetch the timeline for, without the @.
​
cursor
string
Pagination cursor from a previous response’s nextCursor. Omit to fetch the first page.

​
Response

​
tweets
array
Array of tweet payloads, newest first. Empty when the account has no posts or the page is exhausted.
​
nextCursor
string | null
Cursor for the next page. Pass it as the cursor query parameter on the next request. null when there are no further pages.
curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk" \
  -H "x-api-key: YOUR_API_KEY"

{
  "tweets": [
    {
      "id": "1858123456789012345",
      "text": "Example post content",
      "author": {
        "username": "elonmusk",
        "name": "Elon Musk"
      },
      "createdAt": "2026-06-11T18:24:00.000Z"
    }
  ],
  "nextCursor": "DAABCgABGc7hF0lAAAAACgACGc..."
}