Social

X/Twitter Lists

Read an X/Twitter List: its combined tweet timeline, its member roster, or its followers. Billed per item returned. Useful for following a curated set of accounts as one feed.

post/api/tools/x_lists

Request

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

Request body

kind'tweets' | 'members' | 'followers' required

What to read from the list.

idstring required

List ID.

resultsLimitinteger required

MANDATORY: max items returned, billed per item.

sinceTimestring
untilTimestring
includeRepliesboolean

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.