Sign in

832835de69eb

latestOpenAPI 3.1.02026-08-13127104507.5 KB
Tweets

Get full conversation thread for a tweet

Get full conversation thread for a tweet.

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

Path parameters

idstring required

Tweet ID to get thread context

Query parameters

cursorstring

Pagination cursor for thread tweets

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.

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. minLikes is 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.

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

Thread tweets

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"
}