Skip to main content
GET
/
x
/
timeline
Get timeline
curl --request GET \
  --url https://api.example.com/x/timeline \
  --header 'x-api-key: <x-api-key>'
1 credit per result returned · All plans from $0.00012/credit
Requires a connected X account. Uses user-authenticated access.
curl https://xquik.com/api/v1/x/timeline \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Page 2
curl -G https://xquik.com/api/v1/x/timeline \
  --data-urlencode "cursor=abc123" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Query parameters

​
cursor
string
Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.
​
seenTweetIds
string
Comma-separated tweet IDs to exclude from results. Use this to avoid returning tweets the user has already seen.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
tweets
object[]
Array of timeline tweets.
​
has_next_page
boolean
Whether more results are available.
​
next_cursor
string
Opaque cursor for the next page. Empty string when no more results.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Timeline tweet content",
      "createdAt": "2026-02-24T10:00:00.000Z",
      "likeCount": 200,
      "retweetCount": 50,
      "replyCount": 15,
      "url": "https://x.com/user/status/1893456789012345678",
      "author": {
        "id": "44196397",
        "username": "elonmusk",
        "name": "Elon Musk",
        "verified": true
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABF..."
}
Related: Notifications · Bookmarks