# 获取列表推文时间线

**API:** Data API

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

**Tags:** Twitter / X

按 `listId` 获取 X 列表的推文时间线，每页最多 20 条，使用游标分页。返回推文以及 `has_next_page` 和 `next_cursor`。要查看列表中的成员，请使用 `get_twitter_list_members`。

### 计费参考

- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：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 |  |
| `listId` | query | no | string |  |

## Responses

### 200 — 列表推文时间线响应

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

**application/json**

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

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseA06878E34984_ListTweetsTimelineResponse

`#/components/schemas/ResponseA06878E34984_ListTweetsTimelineResponse`

```json
{
  "type": "object",
  "properties": {
    "tweets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseA06878E34984_Tweet"
      },
      "description": "列表中的推文数组"
    },
    "has_next_page": {
      "type": "boolean",
      "description": "表示是否还有更多结果"
    },
    "next_cursor": {
      "type": "string",
      "description": "用于获取下一页结果的游标"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ],
      "example": "success",
      "description": "请求状态"
    },
    "msg": {
      "type": "string",
      "description": "请求的消息；当 status 为 error 时为错误消息"
    }
  }
}
```

### ResponseA06878E34984_Tweet

`#/components/schemas/ResponseA06878E34984_Tweet`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "id": {
      "type": "string",
      "description": "推文的 ID"
    },
    "url": {
      "type": "string",
      "description": "推文的 URL"
    },
    "text": {
      "type": "string",
      "description": "推文文本"
    },
    "source": {
      "type": "string",
      "description": "推文的来源客户端"
    },
    "retweetCount": {
      "type": "integer"
    },
    "replyCount": {
      "type": "integer"
    },
    "likeCount": {
      "type": "integer"
    },
    "quoteCount": {
      "type": "integer"
    },
    "viewCount": {
      "type": "integer"
    },
    "createdAt": {
      "type": "string",
      "description": "推文的创建日期和时间"
    },
    "lang": {
      "type": "string",
      "description": "推文的语言"
    },
    "bookmarkCount": {
      "type": "integer"
    },
    "isReply": {
      "type": "boolean"
    },
    "inReplyToId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "inReplyToUserId": {
      "type": "string"
    },
    "inReplyToUsername": {
      "type": "string"
    },
    "author": {
      "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser"
    }
  }
}
```

### 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"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```