# Lấy thành viên danh sách

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/list/members`

**Tags:** Twitter / X

Liệt kê các tài khoản nằm trong một Danh sách X, 20 mỗi trang, phân trang bằng cursor. Dùng để trích xuất một nhóm sẵn có do con người tuyển chọn — ai đó đã thực hiện việc lọc giúp bạn. Trả về đối tượng người dùng đầy đủ trong `members`. Để đọc bài đăng của các tài khoản đó như một nguồn cấp duy nhất, dùng `get_twitter_list_tweets_timeline`. Với người đăng ký của Danh sách, dùng `get_twitter_list_followers`.

### Tham chiếu giá

- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.0015.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string | Con trỏ của trang |
| `list_id` | query | yes | string | ID của danh sách |

## Responses

### 200 — Phản hồi thành viên danh sách

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ Felo.

**application/json**

Schema: `ResponseA06878E34984_TwitterListMembersResponse` (`#/components/schemas/ResponseA06878E34984_TwitterListMembersResponse`)

### 400 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseA06878E34984_TwitterListMembersResponse

`#/components/schemas/ResponseA06878E34984_TwitterListMembersResponse`

```json
{
  "type": "object",
  "properties": {
    "members": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser"
      }
    },
    "has_next_page": {
      "type": "boolean",
      "description": "Cho biết có thêm kết quả khả dụng hay không"
    },
    "next_cursor": {
      "type": "string",
      "description": "Con trỏ để lấy trang kết quả tiếp theo"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ],
      "description": "Trạng thái của yêu cầu"
    },
    "msg": {
      "type": "string",
      "description": "Thông điệp của yêu cầu, thông điệp lỗi nếu trạng thái là error"
    }
  }
}
```

### ResponseA06878E34984_TwitterUrl

`#/components/schemas/ResponseA06878E34984_TwitterUrl`

```json
{
  "type": "object",
  "properties": {
    "display_url": {
      "type": "string",
      "description": "URL hiển thị"
    },
    "expanded_url": {
      "type": "string",
      "description": "URL mở rộng"
    },
    "indices": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Các chỉ số của URL"
    },
    "url": {
      "type": "string",
      "description": "URL"
    }
  }
}
```

### ResponseA06878E34984_TwitterUser

`#/components/schemas/ResponseA06878E34984_TwitterUser`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Loại người dùng"
    },
    "userName": {
      "type": "string",
      "description": "Tên người dùng"
    },
    "url": {
      "type": "string",
      "description": "URL hồ sơ của người dùng"
    },
    "id": {
      "type": "string",
      "description": "ID của người dùng"
    },
    "name": {
      "type": "string",
      "description": "Tên của người dùng"
    },
    "isBlueVerified": {
      "type": "boolean",
      "description": "Cho biết người dùng có được xác minh tích xanh hay không"
    },
    "verifiedType": {
      "type": "string",
      "description": "Loại xác minh"
    },
    "profilePicture": {
      "type": "string",
      "description": "URL ảnh hồ sơ"
    },
    "coverPicture": {
      "type": "string",
      "description": "URL ảnh bìa"
    },
    "description": {
      "type": "string",
      "description": "Mô tả của người dùng"
    },
    "location": {
      "type": "string",
      "description": "Vị trí của người dùng"
    },
    "followers": {
      "type": "integer",
      "description": "Số người theo dõi"
    },
    "following": {
      "type": "integer",
      "description": "Số tài khoản đang theo dõi"
    },
    "canDm": {
      "type": "boolean",
      "description": "Cho biết người dùng có thể nhận tin nhắn trực tiếp hay không"
    },
    "createdAt": {
      "type": "string",
      "description": "Ngày tạo tài khoản"
    },
    "favouritesCount": {
      "type": "integer",
      "description": "Số lượt yêu thích"
    },
    "hasCustomTimelines": {
      "type": "boolean",
      "description": "Cho biết người dùng có dòng thời gian tùy chỉnh hay không"
    },
    "isTranslator": {
      "type": "boolean",
      "description": "Cho biết người dùng có phải là người dịch hay không"
    },
    "mediaCount": {
      "type": "integer",
      "description": "Số mục phương tiện"
    },
    "statusesCount": {
      "type": "integer",
      "description": "Số lượng trạng thái"
    },
    "withheldInCountries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Danh sách các quốc gia nơi người dùng bị hạn chế"
    },
    "possiblySensitive": {
      "type": "boolean",
      "description": "Cho biết người dùng có nội dung nhạy cảm hay không"
    },
    "pinnedTweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Danh sách ID tweet được ghim"
    },
    "isAutomated": {
      "type": "boolean",
      "description": "Cho biết tài khoản có được tự động hóa hay không"
    },
    "automatedBy": {
      "type": "string",
      "description": "Cho biết ai đã tự động hóa tài khoản"
    },
    "unavailable": {
      "type": "boolean",
      "description": "Cho biết tài khoản có không khả dụng hay không"
    },
    "message": {
      "type": "string",
      "description": "Thông điệp về tài khoản"
    },
    "unavailableReason": {
      "type": "string",
      "description": "Lý do không khả dụng"
    },
    "profile_bio": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "Mô tả tiểu sử"
        },
        "entities": {
          "type": "object",
          "properties": {
            "description": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl"
                  }
                }
              }
            },
            "url": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```
