# 获取列表成员

**API:** Data API

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

**Tags:** Twitter / X

列出 X 列表中包含的账号，每页 20 个，使用游标分页。用它提取现成的、由人工策划的群组——筛选工作已由他人完成。完整的用户对象位于 `members` 下。要像信息流一样读取这些账号发布的帖子，请使用 `get_twitter_list_tweets_timeline`。列表的订阅者请使用 `get_twitter_list_followers`。

### 计费参考

- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.0015 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 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 | 页面游标 |
| `list_id` | query | yes | string | 列表 ID |

## Responses

### 200 — 列表成员响应

Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。

**application/json**

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

### 400 — 无法处理该请求。请检查请求参数。

### 401 — 需要有效的 Felo API 密钥。

### 402 — 由于未满足计费要求，请求无法继续。

### 403 — 该账户无权执行此操作。

### 429 — 已达到请求或支出限额。

### 502 — 服务无法完成该请求。

### 503 — API 或计费服务暂时不可用。

### 504 — 服务在处理请求时超时。

### default — 错误响应；上游透传响应可能采用提供方格式

**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": "表示是否还有更多结果"
    },
    "next_cursor": {
      "type": "string",
      "description": "用于获取下一页结果的游标"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ],
      "description": "请求状态"
    },
    "msg": {
      "type": "string",
      "description": "请求的消息；当 status 为 error 时为错误消息"
    }
  }
}
```

### ResponseA06878E34984_TwitterUrl

`#/components/schemas/ResponseA06878E34984_TwitterUrl`

```json
{
  "type": "object",
  "properties": {
    "display_url": {
      "type": "string",
      "description": "显示用 URL"
    },
    "expanded_url": {
      "type": "string",
      "description": "展开后的 URL"
    },
    "indices": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "URL 的索引位置"
    },
    "url": {
      "type": "string",
      "description": "URL"
    }
  }
}
```

### ResponseA06878E34984_TwitterUser

`#/components/schemas/ResponseA06878E34984_TwitterUser`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "用户类型"
    },
    "userName": {
      "type": "string",
      "description": "用户的用户名"
    },
    "url": {
      "type": "string",
      "description": "用户个人资料的 URL"
    },
    "id": {
      "type": "string",
      "description": "用户 ID"
    },
    "name": {
      "type": "string",
      "description": "用户名"
    },
    "isBlueVerified": {
      "type": "boolean",
      "description": "表示用户是否通过蓝标认证"
    },
    "verifiedType": {
      "type": "string",
      "description": "验证类型"
    },
    "profilePicture": {
      "type": "string",
      "description": "头像图片的 URL"
    },
    "coverPicture": {
      "type": "string",
      "description": "封面图片的 URL"
    },
    "description": {
      "type": "string",
      "description": "用户描述"
    },
    "location": {
      "type": "string",
      "description": "用户所在地"
    },
    "followers": {
      "type": "integer",
      "description": "关注者数"
    },
    "following": {
      "type": "integer",
      "description": "关注数"
    },
    "canDm": {
      "type": "boolean",
      "description": "表示用户是否可接收私信"
    },
    "createdAt": {
      "type": "string",
      "description": "账号创建日期"
    },
    "favouritesCount": {
      "type": "integer",
      "description": "收藏数"
    },
    "hasCustomTimelines": {
      "type": "boolean",
      "description": "表示用户是否有自定义时间线"
    },
    "isTranslator": {
      "type": "boolean",
      "description": "表示用户是否为译者"
    },
    "mediaCount": {
      "type": "integer",
      "description": "媒体项数量"
    },
    "statusesCount": {
      "type": "integer",
      "description": "状态数量"
    },
    "withheldInCountries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "用户被限制的国家/地区列表"
    },
    "possiblySensitive": {
      "type": "boolean",
      "description": "表示用户是否有敏感内容"
    },
    "pinnedTweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "置顶推文 ID 列表"
    },
    "isAutomated": {
      "type": "boolean",
      "description": "表示账号是否为自动化账号"
    },
    "automatedBy": {
      "type": "string",
      "description": "表示账号的自动化操作者"
    },
    "unavailable": {
      "type": "boolean",
      "description": "表示账号是否不可用"
    },
    "message": {
      "type": "string",
      "description": "关于该账号的消息"
    },
    "unavailableReason": {
      "type": "string",
      "description": "不可用原因"
    },
    "profile_bio": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "个人简介"
        },
        "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"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```