Lists

List tweets

Tweets from the members of a list, newest first.

Paginated: pass the bottom cursor of one page as cursor to get the next. Each page is one billed call.

Reference: https://www.twittrapi.com/docs/reference/lists-tweets

get/lists/tweets

Request

  • Base URL: https://api.twittrapi.com
  • URL: https://api.twittrapi.com/lists/tweets
  • Auth: API key in header X-API-KEY

Query parameters

listIdstring required

Numeric list ID, the number in the list URL (x.com/i/lists/<listId>).

countinteger

Number of tweets to ask X for. Sent to X as is; X treats it as a hint and decides how many it returns (follower and following pages often hold 50 to 70 users for count=20). A value that is not a number falls back to 20.

cursorstring

Bottom cursor from the previous page. Leave it out for the first page. See Pagination.

format'raw' | 'simple'

raw (default): X's JSON passed through. simple: flat camelCase JSON with a fixed schema and a {data, nextCursor, previousCursor, hasNextPage} envelope. Same price. The header X-Response-Format: simple does the same.

Response

Raw JSON of X's ListLatestTweetsTimeline query.

With format=simple: Collection of Tweet objects: {data: [Tweet], nextCursor, previousCursor, hasNextPage}.

OR
RawPassthrough required

X's own JSON (raw format, the default), passed through unchanged. The shape is X's and can change; see https://www.twittrapi.com/docs/response-format.

Changes

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