twitter_user_tweets
Fetch a user's recent tweets with pagination, returning text, IDs, timestamps, and engagement metrics. Use cursor for next page and filter retweets/replies via flags.
Instructions
Get a user's recent posting timeline. IMPORTANT: this endpoint does NOT filter server-side, so the response routinely includes retweets and replies alongside original posts. Every item carries is_retweet, is_reply and is_quote booleans, so filter client-side on those flags if you need originals only, and read author.username rather than assuming every item was written by the requested user (a retweet's retweeted_tweet holds the original author). Returns tweet text, id, timestamp, and engagement metrics. Paginate with cursor to go further back. For the full back-catalogue in one call, use twitter_user_tweets_complete.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Max items to return for this page. Typical range 1 to 200; endpoint default (20) applies if omitted. To page through results, pass the cursor from the previous response. | |
| cursor | No | Opaque pagination cursor from a previous response's next_cursor field. Omit on the first call; pass on subsequent calls to fetch the next page. | |
| user_id | No | Numeric Twitter/X user id (e.g. "44196397"). Provide exactly one of username or user_id. | |
| username | No | Twitter/X handle WITHOUT the leading @ (e.g. "elonmusk", "openai"). Provide exactly one of username or user_id. |