> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取用户推文时间线

> 检索用户的推文时间线，按新近程度排序，并支持分页。



## OpenAPI

````yaml openapi/zh/twitter-user-batch_01.json GET /twitter/user/tweet_timeline
openapi: 3.0.3
info:
  title: Twitter API
  version: 1.0.0
  description: Twitter 数据 API，提供用户和推文信息的端点。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /twitter/user/tweet_timeline:
    get:
      tags:
        - https://docs.twitterapi.io/api-reference/endpoint/get_user_timeline
      summary: 获取用户推文时间线
      description: >-
        按用户 ID 获取推文，并按 created_at 逆时间顺序排序。结果采用分页形式，每页最多包含 20 条推文。排序顺序与 Twitter
        应用中用户个人资料页面显示的顺序一致。不支持基于时间的筛选。
      parameters:
        - name: userId
          in: query
          required: false
          schema:
            type: string
          description: 要检索其时间线的用户的用户 ID。
        - name: includeReplies
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: 是否在结果中包含回复。默认为 false。
        - name: includeParentTweet
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: 当推文是回复时，是否包含父推文。默认为 false。
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: 用于对结果进行分页的游标。第一页请留空。
      responses:
        '200':
          description: 用户推文时间线
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserTweetsResponse'
components:
  schemas:
    UserTweetsResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
            - error
        code:
          type: integer
          description: AIsa 封装层返回的提供商状态码。
        msg:
          type: string
        data:
          type: object
          properties:
            tweets:
              type: array
              items:
                type: object
                additionalProperties: true
                description: TwitterAPI.io 返回的推文对象。
            pin_tweet:
              type: object
              nullable: true
              additionalProperties: true
          additionalProperties: true
        has_next_page:
          type: boolean
        next_cursor:
          type: string
          nullable: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````