Tweets

List replies to a tweet

Returns direct replies with automatic maximum coverage and pagination. A retweet ID returns replies to the original post. Complete mode adds nested replies, diagnostics, and a 424 below 80% coverage. A fully read time window returns 200.

get/api/v1/x/tweets/{id}/replies

Path parameters

idstring required

Tweet ID to get replies

Query parameters

cursorstring

Cursor from the previous response. Existing unprefixed cursors keep legacy standard behavior. Pages can be empty before more rows; follow next_cursor.

mode'standard' | 'complete'

Override automatic coverage. Standard uses legacy pagination. Complete adds nested replies, diagnostics, scope, depth, sorting, and original-post controls.

limitinteger

Complete mode defaults to 25,000 combined direct and nested replies. Set a smaller or larger total with limit. Automatic pages accept 1-300. Standard pages accept 1-100.

pageSizeinteger

Automatic pages accept 1-300 Tweets. Standard pages keep 1-100. Default 20. Follow next_cursor while the response reports more pages. Deprecated aliases remain accepted.

scope'all' | 'direct' | 'nested'

Select all replies, direct replies, or nested replies.

maxDepthinteger

Maximum reply depth from the source post.

sort'relevance' | 'latest' | 'oldest' | 'likes'

Sort the selected replies before applying limit.

excludeOriginalAuthorboolean

Exclude replies written by the source-post author.

includeOriginalPostboolean

Include the source post and count it toward limit.

hasMediaOnlyboolean

Only return replies containing media.

sinceTimestring

Inclusive ISO bound for Tweet creation time.

untilTimestring

Exclusive ISO bound for Tweet creation time.

fromUserstring

Filter by author username.

toUserstring

Filter replies sent to a username.

mentioningstring

Filter tweets mentioning a username.

languagestring

Filter by language. Alias lang is accepted.

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 media. Aliases: has_video, has_media.

minLikesinteger

Minimum likes. Aliases: minFaves, min_likes, min_faves.

minRetweetsinteger

Minimum retweets threshold.

minRepliesinteger

Minimum replies threshold.

minQuotesinteger

Minimum quote count threshold.

minViewsinteger

Minimum view count threshold.

minBookmarksinteger

Minimum bookmark count threshold.

maxFavesinteger

Maximum likes threshold. maxLikes is also accepted.

maxRetweetsinteger

Maximum retweets threshold.

maxRepliesinteger

Maximum replies threshold.

maxQuotesinteger

Maximum quotes threshold.

blueVerifiedOnlyboolean

Only return tweets from Blue-verified authors.

cardNamestring

Match the Tweet card name.

sourcestring

Match the source application.

excludeSourcestring

Exclude a source application.

geocodestring

Match latitude, longitude, and radius.

sinceIdstring

Return Tweets whose IDs exceed this ID.

maxIdstring

Return Tweets at or below this ID.

nearstring

Match a place name.

withinstring

Set the radius for the near filter.

withinTimestring
Example:7d

Match Tweets from this recent window, such as 90m or 7d. Use a whole number and s, m, h, or d.

nativeRetweetsboolean

Only return native reposts.

safeboolean

Enable the safe-search filter.

newsboolean

X no longer searches filter:news.

verifiedOnlyboolean

Only return tweets from verified authors.

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

Reply mode. Exclude keeps own-thread replies.

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

Only when the caller requests a repost mode.

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

Only when the caller requests a quote mode.

exactPhrasestring

Match this literal phrase, including any hyphens.

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

List of replies

filtered_countinteger
has_next_pageboolean required
next_cursorstring required
limit_reachedtrue

Present when your limit cut a complete-mode answer. The post has more replies; raise limit to get them all.

messagestring

Explains an answer cut by your limit.

Example response

{
  "tweets": [],
  "has_next_page": false,
  "next_cursor": ""
}

Changes