v

latestOpenAPI 3.1.02026-08-09127104507.8 KB
Tweets

List replies to a tweet

Returns direct replies. Omit mode for automatic maximum coverage with resumable pagination. Complete mode returns nested replies, diagnostics, and 424 when direct coverage stays below 80%.

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

Path parameters

idstring required

Tweet ID to get replies

Query parameters

cursorstring

Cursor from the previous response. Xquik cursors resume automatic coverage. Existing unprefixed cursors keep legacy standard behavior.

mode'standard' | 'complete'

Optional advanced override. Omit mode for automatic maximum direct reply coverage with pagination. Standard keeps legacy pagination. Complete returns direct and nested replies with diagnostics, scope, depth, sorting, and original-post controls.

limitinteger

With mode=complete, maximum combined direct and nested reply rows (1-25000, default 25000). Otherwise this remains the deprecated pageSize alias and accepts only 1-100.

pageSizeinteger

Maximum direct replies per automatic or standard page (1-100, default 20). Omit pageSize with mode=complete. Generated pageSize=20 and the exact default filter bundle are ignored in complete mode. Continue while has_next_page is true. Deprecated limit and count aliases remain accepted outside complete mode.

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

Unix timestamp - return replies posted after this time

untilTimestring

Unix timestamp - return replies posted before this time

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.

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 newer than this Tweet ID.

maxIdstring

Return Tweets older than this Tweet ID.

nearstring

Match a place name.

withinstring

Set the radius for the near filter.

withinTimestring

Match Tweets inside a recent time window.

nativeRetweetsboolean

Only return native reposts.

safeboolean

Enable the safe-search filter.

newsboolean

Only return news results.

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

List of replies

has_next_pageboolean required
next_cursorstring required