Lists

List tweets from an X List

Omit mode for resumable maximum coverage. Pass next_cursor unchanged. Standard keeps legacy pagination.

get/x/lists/{id}/tweets

Path parameters

idstring required

X List ID.

Query parameters

cursorstring

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

mode'standard' | 'coverage'

Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Coverage returns diagnostics once and rejects cursors.

pageSizeinteger

Automatic pages accept 1-300 Tweets. Standard pages keep 1-100. Default 20. Continue while has_next_page is true. Deprecated aliases remain accepted.

sinceTimestring

Inclusive ISO bound for Tweet creation time.

untilTimestring

Exclusive ISO bound for Tweet creation time.

includeRepliesboolean

Include reply tweets.

fromUserstring

Filter by author username.

toUserstring

Filter replies sent to a username.

mentioningstring

Filter tweets mentioning a username.

languagestring

Only when the caller requests a language. lang is also 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 by media type. has_video=true and has_media=true are also accepted.

minLikesinteger

Minimum likes threshold. minFaves, min_likes, and min_faves are also accepted.

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.

nativeRetweetsboolean

Only return native reposts.

verifiedOnlyboolean

Only return tweets from verified authors.

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

Only when the caller requests a reply mode.

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

Only when the caller requests a repost 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.

Response

List tweets

filtered_countinteger
has_next_pageboolean required
next_cursorstring required

Example response

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

Changes