v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB
Users

List a user's With Replies timeline

Returns the user's timeline with replies included by default.

get/x/users/{id}/replies

Path parameters

idstring required

Target user ID or username for the replies timeline.

Query parameters

cursorstring

Pagination cursor for user replies

pageSizeinteger

Maximum page items (1-100, default 20). Source, filters, or credits can reduce results. Continue while has_next_page is true. Deprecated limit and count aliases remain accepted.

includeParentTweetboolean

Include each reply's parent tweet.

fromUserstring

Filter by author username.

toUserstring

Filter replies sent to a username.

mentioningstring

Filter tweets mentioning a username.

languagestring

Language code filter, e.g. en or tr.

sinceDatestring date

Start date in YYYY-MM-DD format.

untilDatestring date

End date in YYYY-MM-DD format.

mediaType'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none'

Filter by media type.

minFavesinteger

Minimum likes threshold.

minRetweetsinteger

Minimum retweets threshold.

minRepliesinteger

Minimum replies threshold.

minQuotesinteger

Minimum quote count threshold.

verifiedOnlyboolean

Only return tweets from verified authors.

replies'include' | 'exclude' | 'only'

Reply mode.

retweets'include' | 'exclude' | 'only'

Retweet mode.

quotes'include' | 'exclude' | 'only'

Quote mode.

exactPhrasestring

Exact phrase to match.

excludeWordsstring

Words or quoted phrases to exclude. Separate with spaces, commas, or lines.

anyWordsstring

Words or quoted phrases where any one can match. Separate with spaces, commas, or lines.

hashtagsstring

Hashtags separated by spaces, commas, or lines.

cashtagsstring

Cashtags separated by spaces, commas, or lines.

urlstring

URL substring or domain filter.

conversationIdstring

Conversation ID filter.

inReplyToTweetIdstring

Only replies to this tweet ID.

quotesOfTweetIdstring

Only quotes of this tweet ID.

retweetsOfTweetIdstring

Only retweets of this tweet ID.

Response

User timeline with replies

has_next_pageboolean required
next_cursorstring required

Example response

{
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "retweetCount": 5,
      "replyCount": 3,
      "likeCount": 42,
      "quoteCount": 1,
      "viewCount": 1500,
      "bookmarkCount": 2
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}