Lists

List followers of an X List

Returns List followers with resumable or standard pagination.

get/x/lists/{id}/followers

Path parameters

idstring required

X List ID.

Query parameters

cursorstring

Cursor from the previous response. Existing unprefixed cursors keep legacy standard behavior. Pages can be empty before more rows; follow next_cursor.

mode'standard' | 'coverage'

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

pageSizeinteger

Maximum user profiles: automatic 300; standard 200. Sources return fewer profiles. Follow next_cursor while the response reports more pages.

minFollowersinteger

Minimum follower count. Filtering happens before billing.

maxFollowersinteger

Maximum follower count. Missing counts pass this maximum.

minFollowinginteger

Profiles must follow at least this many accounts.

maxFollowinginteger

Profiles may follow at most this many accounts.

minStatusesinteger

Minimum post count. minPosts is also accepted.

maxStatusesinteger

Maximum post count. maxPosts is also accepted.

minAccountAgeDaysinteger

Minimum account age in whole days.

verifiedOnlyboolean

Only return verified profiles.

verifiedTypestring

Match the verification type exactly, ignoring case.

hasWebsiteboolean

Only return profiles with a website.

hasLocationboolean

Only return profiles with a location.

bioContainsstring

Match any comma-separated or line-separated bio term, ignoring case.

locationContainsstring

Match a location substring, ignoring case.

usernameContainsstring

Match a username substring, ignoring case.

Response

List profiles

OR

Example response

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

Changes