Social

X/Twitter Timeline

Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.

post/api/tools/x_timeline

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/x_timeline
  • Auth: none declared

Request body

kind'user-tweets' | 'user-replies' | 'user-likes' | 'user-media' | 'user-mentions' | 'followers' | 'following' | 'verified-followers' | 'tweet-replies' | 'tweet-quotes' | 'tweet-thread' | 'tweet-favoriters' | 'tweet-retweeters' required

Which timeline to fetch.

idstring required

User ID/username or tweet ID (depends on kind).

resultsLimitinteger required

MANDATORY: max items returned, billed per item.

includeRepliesboolean
includeParentTweetboolean
languagestring
mediaType'images' | 'videos' | 'gifs' | 'media'
minFavesinteger
verifiedOnlyboolean

Response

Result dataset.

itemsobject[] required

Array of returned items. Shape varies per tool — see each tool's documentation.

runIdstring

Run ID for debugging/audit.

durationinteger

Run duration in seconds.

Changes

No recorded changes to this operation across all 1 revision of this API.