---
title: "Get List Members by Page"
method: POST
path: "/twitter/list/members/page"
tags: ["Lists Endpoints"]
---

# Get List Members by Page

`POST /twitter/list/members/page`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/twitter/list/members/page`
- Auth: HTTP bearer

Retrieve a paginated list of list members using cursor-based pagination. Each page returns up to 20 members. Pass next_cursor from the previous response to continue. Pricing: $0.05 per 1,000 members.

## Request body

- GetListMembersCursorQuery
  - `next_cursor` string, nullable: Cursor returned by the previous page. Leave empty to fetch the first page.
  - `list_id` string, required: The ID of the list to get members from.

## Response `200`

Current page data (up to 20 members) and pagination metadata (has_next_page, next_cursor).

- GetListMembersCursorResponse
  - `code` integer, required: The status code of the response.
  - `msg` string, required: The message of the response.
  - `data` UserModel[], required: A list of user objects.
    - `id` string, required: User ID
    - `name` string, required: Display name
    - `screen_name` string, required: Twitter username
    - `created_at` string, nullable: Account creation date
    - `created_at_datetime` string, nullable: Account creation datetime in ISO format
    - `can_dm` boolean, nullable: Whether the user can be direct messaged
    - `can_media_tag` boolean, nullable: Whether the user can be tagged in media
    - `default_profile` boolean, nullable: Whether the user has a default profile
    - `default_profile_image` boolean, nullable: Whether the user has a default profile image
    - `description` string, nullable: User's bio description
    - `description_urls` string[]: List of URLs found in the user's description
    - `urls` UrlModel[], nullable: List of URLs found in the user's profile
      - `url` string, required: URL
      - `expanded_url` string, nullable: Expanded URL
      - `display_url` string, nullable: Display URL
    - `fast_followers_count` integer, nullable: Count of fast followers
    - `favourites_count` integer, nullable: Number of tweets the user has liked
    - `followers_count` integer, nullable: Number of followers
    - `following_count` integer, nullable: Number of users this user is following
    - `has_custom_timelines` boolean, nullable: Whether the user has custom timelines
    - `is_blue_verified` boolean, nullable: Blue verification status
    - `verified_type` string, nullable: Verification badge type when not blue-only: blue, business, government, etc.
    - `is_verified` boolean, nullable: True if the account has any verification badge (blue, business, government, or legacy verified)
    - `profile_image_shape` string, nullable: Profile image shape (Circle or Square; Square often indicates business/government)
    - `is_translator` boolean, nullable: Whether the user is a translator
    - `listed_count` integer, nullable: Number of public lists the user is a member of
    - `location` string, nullable: User's location
    - `media_count` integer, nullable: Number of media tweets posted by the user
    - `normal_followers_count` integer, nullable: Count of normal followers
    - `pinned_tweet_ids` string[]: List of pinned tweet IDs
    - `possibly_sensitive` boolean, nullable: Whether the user's profile may contain sensitive content
    - `profile_banner_url` string, nullable: URL of the user's profile banner
    - `profile_image_url` string, nullable: URL of the user's profile image
    - `protected` boolean, nullable: Whether the user's tweets are protected
    - `statuses_count` integer, nullable: Number of tweets posted by the user
  - `has_next_page` boolean, required: Whether another page is available.
  - `next_cursor` string, nullable: The next cursor of the members to get.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)