Skip to content
cheapxapi
All endpoints

Get user's tweet timeline

GET/twitter/user/tweet_timeline

Tweet timeline of a user by numeric user ID. The list is inside data.tweets. Paginated: use cursor / next_cursor.

Price: $0.0006 per request.

Parameters

  • userIdstring

    Numeric user ID, e.g. 11348282.

    Example: 11348282

  • includeRepliesboolean

    Include replies (true / false).

  • includeParentTweetboolean

    Include the parent tweet of replies (true / false).

  • cursorstring

    Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response.

Example request

curl "https://api.cheapxapi.com/twitter/user/tweet_timeline" \
  -H "x-api-key: YOUR_KEY"

Response

Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.

FieldType
statusstring
msgstring
codeinteger
dataobject
tweetsarray of Tweet
has_next_pageboolean
next_cursorstring

Status codes

200
Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.
400
Invalid parameters (charged), or API key placed in the URL (not charged).
401
Missing or invalid API key (not charged).
402
Insufficient balance (not charged).
403
Account disabled (not charged).
404
Unknown endpoint (charged), or the requested item could not be found (not charged). Note: many endpoints report a missing user/tweet as HTTP 200 with "status":"error" instead; those are charged.
405
Only GET is supported (not charged).
429
Rate limit exceeded (not charged). Retry after the time in the Retry-After header.
503
Temporary service problem, or the endpoint is temporarily unavailable (not charged). Retry with exponential backoff.