# 获取用户笔记列表

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v2/crawler/user/posted:
    get:
      summary: 获取用户笔记列表
      deprecated: false
      description: >-
        获取用户**发布**的笔记列表，游标翻页。


        ### 参数


        | 参数 | 必填 | 默认 | 说明 |

        |---|---|---|---|

        | `user_id` | 是 | — | 用户 ID，24 位十六进制 |

        | `cursor` | 否 | 空 | 翻页游标。首次留空，翻页传上次返回的 `cursor` |

        | `num` | 否 | `20` | 每页数量，1~20 |


        ### 示例


        ```bash

        # 第一页

        curl
        'https://rnote.dev/api/v2/crawler/user/posted?user_id=61b46d790000000010008153&num=20'
        -H 'X-API-Key: sk-你的Key'


        # 下一页（cursor 取自上一次响应）

        curl
        'https://rnote.dev/api/v2/crawler/user/posted?user_id=61b46d790000000010008153&cursor=上一次的cursor'
        -H 'X-API-Key: sk-你的Key'

        ```


        ### 返回


        `$.data.data`：`notes`（笔记数组：id、标题、封面、类型、互动计数）、`has_more`、`tags`。


        `has_more` 为 `false` 时停止翻页。


        ### 注意


        对方设置了主页不可见时会返回空列表。
      operationId: get_user_posted_notes_api_v2_crawler_user_posted_get
      tags:
        - 小红书数据接口 V2
        - 小红书数据接口 V2
      parameters:
        - name: user_id
          in: query
          description: 用户ID
          required: true
          example: 61b46d790000000010008153
          schema:
            type: string
            description: 用户ID
            title: User Id
        - name: cursor
          in: query
          description: 分页游标，首次请求留空，翻页时传入上一次响应中的 cursor 值
          required: false
          schema:
            type: string
            description: 分页游标，首次请求留空，翻页时传入上一次响应中的 cursor 值
            default: ''
            title: Cursor
        - name: num
          in: query
          description: 每页数量，默认 20
          required: false
          schema:
            type: integer
            maximum: 20
            minimum: 1
            description: 每页数量，默认 20
            default: 20
            title: Num
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: string
          headers: {}
          x-apifox-name: ''
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          headers: {}
          x-apifox-name: ''
      security:
        - API Key: []
          x-apifox:
            schemeGroups:
              - id: G9GGDcBNRb1vM2RrBg6RO
                schemeIds:
                  - API Key
            required: true
            use:
              id: G9GGDcBNRb1vM2RrBg6RO
            scopes:
              G9GGDcBNRb1vM2RrBg6RO:
                API Key: []
      x-apifox-folder: 小红书数据接口 V2
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7909900/apis/api-456970839-run
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
      x-apifox-orders:
        - detail
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          type: string
        ctx:
          type: object
          title: Context
          x-apifox-orders: []
          properties: {}
          x-apifox-ignore-properties: []
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
      x-apifox-orders:
        - loc
        - msg
        - type
        - input
        - ctx
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    API Key:
      type: apikey
      description: '在此输入 API Key (格式: sk-xxx)，所有 /api/v1/* 接口需要携带'
      in: header
      name: X-API-Key
    InternalKey:
      type: apikey
      description: 内部调用方服务密钥（机器平面），形如 `thk-int-{id}-{secret}`。
      in: header
      name: X-Internal-Key
    UserSession:
      type: apikey
      description: 终端用户会话令牌（门户平面），登录后由门户签发。
      in: header
      name: X-User-Session
    StaffSession:
      type: apikey
      description: 管理后台员工会话 cookie（管理平面），登录后种下。
      in: cookie
      name: admin_session
    Combination:
      group:
        - id: 1724839
        - id: 1724840
      type: combination
servers:
  - url: https://rnote.dev
    description: 正式环境
security: []

```