@tikomni/skills 0.1.2 → 0.1.4

package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-api.md

@@ -1,1291 +0,0 @@
-# Xiaohongshu-App-API Full Contract
-
-- Back to index: [`api-capability-index.md`](../api-capability-index.md)
-- Back to route summary: [`api-tags/xiaohongshu-app-api.md`](../api-tags/xiaohongshu-app-api.md)
-- Current contract file: `api-contracts/xiaohongshu-app-api.md`
-- Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
-- Fetched at: `2026-03-08T06:54:04+00:00`
-- Route count: `12`
-- Default auth: Header `Authorization` Bearer
-- Read this file only when you need precise auth notes, parameter descriptions, defaults, examples, or success-response fields.
-- Tag description: **(小红书App数据接口/Xiaohongshu-App-API data endpoints)** - 第二优先/Second choice
-
-## Route Contracts
-
-<a id="get-api-u1-v1-xiaohongshu-app-extract-share-info"></a>
-### `GET /api/u1/v1/xiaohongshu/app/extract_share_info`
-
-- Summary: 提取分享链接信息/Extract share link info
-- Capabilities: general
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `extract_share_info_api_v1_xiaohongshu_app_extract_share_info_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 从分享链接中提取笔记ID和xsec_token
-> ### 参数:
-> - share_link: 小红书分享链接，支持短链接和长链接
-> ### 返回:
-> - 提取的信息对象，包含：
->     - note_id: 笔记ID
->     - xsec_token: 安全令牌（如果URL中包含）
->
-> ### 使用说明:
-> - 支持短链接格式：https://xhslink.com/a/xxxxx
-> - 支持长链接格式：
->     - https://www.xiaohongshu.com/discovery/item/xxxxx
->     - https://www.xiaohongshu.com/explore/xxxxx
-> - 短链接会自动重定向获取真实链接
-> - 提取的note_id可用于get_note_info接口
->
-> # [English]
-> ### Purpose:
-> - Extract note ID and xsec_token from share link
-> ### Parameters:
-> - share_link: Xiaohongshu share link, support short and long links
-> ### Return:
-> - Extracted info object containing:
->     - note_id: Note ID
->     - xsec_token: Security token (if exists in URL)
->
-> ### Usage Guide:
-> - Supports short link format: https://xhslink.com/a/xxxxx
-> - Supports long link formats:
->     - https://www.xiaohongshu.com/discovery/item/xxxxx
->     - https://www.xiaohongshu.com/explore/xxxxx
-> - Short links will be auto-redirected to get real link
-> - Extracted note_id can be used in get_note_info endpoint
->
-> # [示例/Example]
-> share_link="https://xhslink.com/a/EZ4M9TwMA6c3"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| share_link | query | string | Yes | 分享链接/Share link | None | https://xhslink.com/a/EZ4M9TwMA6c3 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-note-comments"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_note_comments`
-
-- Summary: 获取笔记评论/Get note comments
-- Capabilities: comments / content details
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_note_comments_api_v1_xiaohongshu_app_get_note_comments_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取笔记的评论列表
-> ### 参数:
-> - note_id: 笔记ID（必需）
-> - start: 翻页游标，从上一次请求的响应中获取，支持两种格式：
->     1. 简单格式: "682b0133000000001c03618d"
->     2. JSON格式: {"cursor":"682b0133000000001c03618d","index":2,"pageArea":"ALL"}
-> - sort_strategy: 排序策略
->     - 1: 默认排序（默认值）
->     - 2: 按最新评论排序
-> ### 返回:
-> - 评论数据对象，包含：
->     - comments: 评论列表数组，每个评论包含：
->         - id: 评论ID
->         - content: 评论内容
->         - create_time: 创建时间戳
->         - user_info: 评论者信息
->             - user_id: 用户ID
->             - nickname: 昵称
->             - image: 头像URL
->         - interact_info: 互动数据
->             - liked_count: 点赞数
->         - sub_comment_count: 子评论数量
->         - sub_comment_cursor: 子评论翻页游标（如有子评论）
->     - cursor: 翻页游标，用于获取下一页
->     - has_more: 是否有更多数据（布尔值）
->     - total: 总评论数
->
-> ### 翻页说明:
-> - 首次请求不传start参数
-> - 获取下一页时，将上一次返回的cursor作为start参数传入
-> - 当has_more为false时，表示没有更多数据
->
-> # [English]
-> ### Purpose:
-> - Get note comments list
-> ### Parameters:
-> - note_id: Note ID (required)
-> - start: Pagination cursor from previous response, supports two formats:
->     1. Simple format: "682b0133000000001c03618d"
->     2. JSON format: {"cursor":"682b0133000000001c03618d","index":2,"pageArea":"ALL"}
-> - sort_strategy: Sort strategy
->     - 1: Default sort (default)
->     - 2: Sort by latest comments
-> ### Return:
-> - Comments data object containing:
->     - comments: Comment list array, each comment includes:
->         - id: Comment ID
->         - content: Comment content
->         - create_time: Creation timestamp
->         - user_info: Commenter info
->             - user_id: User ID
->             - nickname: Nickname
->             - image: Avatar URL
->         - interact_info: Interaction data
->             - liked_count: Like count
->         - sub_comment_count: Sub-comment count
->         - sub_comment_cursor: Sub-comment pagination cursor (if has sub-comments)
->     - cursor: Pagination cursor for next page
->     - has_more: Whether has more data (boolean)
->     - total: Total comment count
->
-> ### Pagination Guide:
-> - Don't pass start parameter for first request
-> - For next page, pass cursor from previous response as start parameter
-> - When has_more is false, no more data available
->
-> # [示例/Example]
-> note_id="677d1909000000002002a892"
-> sort_strategy=1
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| note_id | query | string | Yes | 笔记ID/Note ID | None | 677d1909000000002002a892 | None |
-| start | query | string | No | 翻页游标/Pagination cursor | None | 682b0133000000001c03618d | None |
-| sort_strategy | query | integer | No | 排序策略：1-默认排序，2-最新评论/Sort strategy: 1-default, 2-latest | 1 | 1 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-note-info"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_note_info`
-
-- Summary: 获取笔记信息 V1/Get note info V1
-- Capabilities: content details
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_note_info_v1_api_v1_xiaohongshu_app_get_note_info_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取笔记信息 V1
-> ### 接口优先级:
-> - 小红书接口推荐优先级: `App V2` > `App（本接口）` > `Web V2` > `Web`
-> ### 参数:
-> - note_id: 笔记ID，可以从小红书的分享链接中获取
-> - share_text: 小红书分享链接（支持APP和Web端分享链接）
-> - 优先使用`note_id`，如果没有则使用`share_text`，两个参数二选一，如都携带则以`note_id`为准。
-> ### 返回:
-> - 笔记详情数据，包含以下主要字段：
->     - note_id: 笔记ID
->     - title: 笔记标题
->     - desc: 笔记内容描述
->     - type: 笔记类型（normal=图文笔记，video=视频笔记）
->     - user: 作者信息对象
->         - user_id: 用户ID
->         - nickname: 用户昵称
->         - avatar: 用户头像URL
->     - image_list: 图片列表（图文笔记）
->     - video_info: 视频信息（视频笔记）
->     - interact_info: 互动数据
->         - liked_count: 点赞数
->         - collected_count: 收藏数
->         - comment_count: 评论数
->         - share_count: 分享数
->     - tag_list: 话题标签列表
->     - time: 发布时间戳
->     - ip_location: IP属地
->
-> # [English]
-> ### Purpose:
-> - Get note info V1
-> ### API Priority:
-> - Xiaohongshu API priority: `App V2` > `App (this)` > `Web V2` > `Web`
-> ### Parameters:
-> - note_id: Note ID, can be obtained from the sharing link of Xiaohongshu website.
-> - share_text: Xiaohongshu sharing link (support APP and Web sharing link)
-> - Prefer to use `note_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `note_id` shall prevail.
-> ### Return:
-> - Note detail data with main fields:
->     - note_id: Note ID
->     - title: Note title
->     - desc: Note content description
->     - type: Note type (normal=image note, video=video note)
->     - user: Author info object
->         - user_id: User ID
->         - nickname: User nickname
->         - avatar: User avatar URL
->     - image_list: Image list (for image notes)
->     - video_info: Video info (for video notes)
->     - interact_info: Interaction data
->         - liked_count: Like count
->         - collected_count: Collect count
->         - comment_count: Comment count
->         - share_count: Share count
->     - tag_list: Topic tag list
->     - time: Publish timestamp
->     - ip_location: IP location
->
-> # [示例/Example]
-> note_id="665f95200000000006005624"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| note_id | query | string | No | 笔记ID/Note ID | None | 665f95200000000006005624 | None |
-| share_text | query | string | No | 分享链接/Share link | None | https://xhslink.com/a/EZ4M9TwMA6c3 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-note-info-v2"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_note_info_v2`
-
-- Summary: 获取笔记信息 V2 (蒲公英商家后台)/Get note info V2 (Pugongying Business Backend)
-- Capabilities: content details
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_note_info_v2_api_v1_xiaohongshu_app_get_note_info_v2_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取笔记信息 V2
-> - 除赞、评、藏数据之外此接口能获取到笔记的曝光量（impNum）、阅读量（readNum）、关注量（followCnt）。
-> - 但是不是每一篇都有，如果是没有被小红书后台收录的笔记，赞评藏数据返回为0，但是笔记内容是完整的。
-> - 通过作者userId，可以去作品列表接口拿到赞、评、藏数据
-> ### 参数:
-> - note_id: 笔记ID，可以从小红书的分享链接中获取
-> - share_text: 小红书分享链接（支持APP和Web端分享链接）
-> - 优先使用`note_id`，如果没有则使用`share_text`，两个参数二选一，如都携带则以`note_id`为准。
-> ### 返回:
-> - 笔记详情数据，包含以下主要字段：
->     - note_id: 笔记ID
->     - title: 笔记标题
->     - desc: 笔记内容描述
->     - type: 笔记类型（normal=图文笔记，video=视频笔记）
->     - user: 作者信息对象
->         - user_id: 用户ID
->         - nickname: 用户昵称
->         - avatar: 用户头像URL
->     - image_list: 图片列表（图文笔记）
->     - video_info: 视频信息（视频笔记）
->     - interact_info: 互动数据
->         - liked_count: 点赞数
->         - collected_count: 收藏数
->         - comment_count: 评论数
->         - share_count: 分享数
->     - tag_list: 话题标签列表
->     - time: 发布时间戳
->     - ip_location: IP属地
->
-> # [English]
-> ### Purpose:
-> - Get note info V2
-> - This interface can get note exposure (impNum), read count (readNum), and follow count (followCnt) in addition to like, comment, and collect data.
-> - However, not every note has this data. If the note is not indexed by Xiaohongshu backend, like, comment, and collect data will return 0, but the note content is complete.
-> - You can get like, comment, and collect data from the note list interface using the author's userId.
-> ### Parameters:
-> - note_id: Note ID, can be obtained from the sharing link of Xiaohongshu website.
-> - share_text: Xiaohongshu sharing link (support APP and Web sharing link)
-> - Prefer to use `note_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `note_id` shall prevail.
-> ### Return:
-> - Note detail data with main fields:
->     - note_id: Note ID
->     - title: Note title
->     - desc: Note content description
->     - type: Note type (normal=image note, video=video note)
->     - user: Author info object
->         - user_id: User ID
->         - nickname: User nickname
->         - avatar: User avatar URL
->     - image_list: Image list (for image notes)
->     - video_info: Video info (for video notes)
->     - interact_info: Interaction data
->         - liked_count: Like count
->         - collected_count: Collect count
->         - comment_count: Comment count
->         - share_count: Share count
->     - tag_list: Topic tag list
->     - time: Publish timestamp
->     - ip_location: IP location
->
-> # [示例/Example]
-> note_id="665f95200000000006005624"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| note_id | query | string | No | 笔记ID/Note ID | None | 665f95200000000006005624 | None |
-| share_text | query | string | No | 分享链接/Share link | None | https://xhslink.com/a/EZ4M9TwMA6c3 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-notes-by-topic"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_notes_by_topic`
-
-- Summary: [已弃用/Deprecated] 根据话题标签获取作品/Get notes by topic
-- Capabilities: content details / topics
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_notes_by_topic_api_v1_xiaohongshu_app_get_notes_by_topic_get`
-
-#### Notes
-
-> # [中文]
-> ## ⚠️ 此接口已弃用，不再维护，可能无法正常使用。
-> ### 用途:
-> - 根据话题标签获取相关笔记
-> ### 参数:
-> - page_id: 话题标签ID（必需）
-> - first_load_time: 首次请求的时间戳，毫秒级时间戳（必需）
->     - 例子: 1698647850000
->     - Python获取当前时间戳: `int(time.time() * 1000)`
-> - sort: 排序方式
->     - "hot": 综合排序（默认）
->     - "time": 最新发布
->     - "trend": 最热门
-> - session_id: 会话ID，首次不传，由服务端生成，翻页时传入
-> - last_note_ct: 最后一条笔记的create_time字段，首次不传，翻页时传入
-> - last_note_id: 最后一条笔记的ID，首次不传，翻页时传入
-> - cursor_score: 最后一条笔记的cursor_score字段，首次不传，翻页时传入
-> ### 返回:
-> - 话题笔记数据，包含：
->     - notes: 笔记列表数组，每个元素包含：
->         - id: 元素ID
->         - model_type: 模型类型（通常为"note"）
->         - note: 笔记详情对象
->             - note_id: 笔记ID
->             - title: 标题
->             - desc: 描述
->             - type: 类型（normal/video）
->             - user: 作者信息
->             - interact_info: 互动数据
->             - cover: 封面图
->             - create_time: 创建时间戳
->             - cursor_score: 游标分数（用于翻页）
->     - session_id: 会话ID（翻页必需）
->     - has_more: 是否有更多数据
->
-> ### 翻页说明:
-> - 首次请求：只传page_id和first_load_time
-> - 翻页请求：需要传入
->     1. 上一次返回的session_id
->     2. 最后一条笔记的last_note_ct（create_time）
->     3. 最后一条笔记的last_note_id（id）
->     4. 最后一条笔记的cursor_score
->
-> # [English]
-> ## ⚠️ This endpoint is deprecated, no longer maintained, and may not work properly.
-> ### Purpose:
-> - Get notes by topic tag
-> ### Parameters:
-> - page_id: Topic tag ID (required)
-> - first_load_time: First load timestamp in milliseconds (required)
->     - Example: 1698647850000
->     - Get current timestamp in Python: `int(time.time() * 1000)`
-> - sort: Sort method
->     - "hot": Comprehensive (default)
->     - "time": Latest published
->     - "trend": Trending
-> - session_id: Session ID, not required for first request, use returned value for pagination
-> - last_note_ct: Last note create_time field for pagination
-> - last_note_id: Last note ID for pagination
-> - cursor_score: Last note cursor_score field for pagination
-> ### Return:
-> - Topic notes data containing:
->     - notes: Notes list array, each element includes:
->         - id: Element ID
->         - model_type: Model type (usually "note")
->         - note: Note detail object
->             - note_id: Note ID
->             - title: Title
->             - desc: Description
->             - type: Type (normal/video)
->             - user: Author info
->             - interact_info: Interaction data
->             - cover: Cover image
->             - create_time: Creation timestamp
->             - cursor_score: Cursor score (for pagination)
->     - session_id: Session ID (required for pagination)
->     - has_more: Whether has more data
->
-> ### Pagination Guide:
-> - First request: Only pass page_id and first_load_time
-> - Next requests: Need to pass
->     1. session_id from previous response
->     2. last_note_ct (create_time of last note)
->     3. last_note_id (id of last note)
->     4. cursor_score of last note
->
-> # [示例/Example]
-> page_id="5c014b045b29cb0001ead530"
-> first_load_time="1698647850000"
-> sort="hot"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| page_id | query | string | Yes | 话题标签ID/Topic tag ID | None | 5c014b045b29cb0001ead530 | None |
-| first_load_time | query | string | Yes | 首次请求时间戳（毫秒）/First load timestamp (ms) | None | 1698647850000 | None |
-| sort | query | string | No | 排序方式：hot-综合，time-最新，trend-最热/Sort: hot-comprehensive, time-latest, trend-trending | hot | hot | None |
-| session_id | query | string | No | 会话ID/Session ID | None | 989615e2-ce54-414a-9c7a-6c1e5e79c5f7 | None |
-| last_note_ct | query | string | No | 最后一条笔记创建时间/Last note create time | None | 1698647850000 | None |
-| last_note_id | query | string | No | 最后一条笔记ID/Last note ID | None | 653f4f2a0000000025017109 | None |
-| cursor_score | query | string | No | 游标分数/Cursor score | None | rNqgDUXZhHqdL4z4kKah5Lw6P_OSU9_fgubmTsiop_s | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-product-detail"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_product_detail`
-
-- Summary: 获取商品详情/Get product detail
-- Capabilities: details / commerce
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_product_detail_api_v1_xiaohongshu_app_get_product_detail_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取小红书商品详情信息
-> ### 参数:
-> - sku_id: 商品skuId（必需）
-> ### 返回:
-> - 商品详情数据
->
-> # [English]
-> ### Purpose:
-> - Get Xiaohongshu product detail info
-> ### Parameters:
-> - sku_id: Product SKU ID (required)
-> ### Return:
-> - Product detail data
->
-> # [示例/Example]
-> sku_id="68be7cbc8c331700011f89d1"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| sku_id | query | string | Yes | 商品skuId/Product SKU ID | None | 68be7cbc8c331700011f89d1 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-sub-comments"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_sub_comments`
-
-- Summary: 获取子评论/Get sub comments
-- Capabilities: comments
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_sub_comments_api_v1_xiaohongshu_app_get_sub_comments_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取评论的子评论（回复）列表
-> ### 参数:
-> - note_id: 笔记ID（必需）
-> - comment_id: 一级评论ID，要查看哪条评论的子评论（必需）
-> - start: 翻页游标，从上一次请求的响应中获取，从评论列表的最后一条子评论ID获取：
->     格式如下: "6806642d000000001f01991b"
-> ### 返回:
-> - 子评论列表数组，每个子评论包含：
->     - id: 子评论ID
->     - content: 评论内容
->     - create_time: 创建时间戳
->     - user_info: 评论者信息
->         - user_id: 用户ID
->         - nickname: 昵称
->         - image: 头像URL
->     - target_comment: 被回复的评论信息（如果是回复其他子评论）
->         - id: 被回复评论ID
->         - user_info: 被回复者信息
->             - nickname: 被回复者昵称
->
-> ### 翻页说明:
-> - 首次请求不传start参数
-> - 获取更多时，将上一次请求返回的最后一条子评论ID作为start参数
->
-> # [English]
-> ### Purpose:
-> - Get sub comments (replies) list
-> ### Parameters:
-> - note_id: Note ID (required)
-> - comment_id: Parent comment ID to get sub comments (required)
-> - start: Pagination cursor from previous response, obtained from the last sub-comment ID in the comment list:
->     Format: "6806642d000000001f01991b"
-> ### Return:
-> - Sub comments array list, each sub-comment includes:
->     - id: Sub-comment ID
->     - content: Comment content
->     - create_time: Creation timestamp
->     - user_info: Commenter info
->         - user_id: User ID
->         - nickname: Nickname
->         - image: Avatar URL
->     - target_comment: Replied comment info (if replying to other sub-comment)
->         - id: Replied comment ID
->         - user_info: Replied user info
->             - nickname: Replied user nickname
->
-> ### Pagination Guide:
-> - Don't pass start parameter for first request
-> - For more data, pass last sub-comment ID from previous response as start parameter
->
-> # [示例/Example]
-> note_id="677d1909000000002002a892"
-> comment_id="677f67e400000000220013f3"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| note_id | query | string | Yes | 笔记ID/Note ID | None | 677d1909000000002002a892 | None |
-| comment_id | query | string | Yes | 一级评论ID/Parent comment ID | None | 677f67e400000000220013f3 | None |
-| start | query | string | No | 翻页游标/Pagination cursor | None | 6806642d000000001f01991b | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-user-id-and-xsec-token"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_user_id_and_xsec_token`
-
-- Summary: 从分享链接中提取用户ID和xsec_token/Extract user ID and xsec_token from share link
-- Capabilities: profiles / accounts
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_user_id_and_xsec_token_api_v1_xiaohongshu_app_get_user_id_and_xsec_token_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 从用户分享链接中提取用户ID和xsec_token
-> ### 参数:
-> - share_link: 小红书用户分享链接，支持短链接和长链接
-> ### 返回:
-> - 提取的信息对象，包含：
->     - user_id: 用户ID
->     - xsec_token: 安全令牌（如果URL中包含）
->
-> ### 使用说明:
-> - 支持短链接格式：https://xhslink.com/m/xxxxx
-> - 支持长链接格式：https://www.xiaohongshu.com/user/profile/xxxxx
-> - 提取的user_id可用于get_user_info接口
->
-> # [English]
-> ### Purpose:
-> - Extract user ID and xsec_token from user share link
-> ### Parameters:
-> - share_link: Xiaohongshu user share link, support short and long links
-> ### Return:
-> - Extracted info object containing:
->     - user_id: User ID
->     - xsec_token: Security token (if exists in URL)
->
-> ### Usage Guide:
-> - Supports short link format: https://xhslink.com/m/xxxxx
-> - Supports long link format: https://www.xiaohongshu.com/user/profile/xxxxx
-> - Extracted user_id can be used in get_user_info endpoint
-> # [示例/Example]
-> share_link="https://xhslink.com/m/Ap1vXtgAixh"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| share_link | query | string | Yes | 用户分享链接/User share link | None | https://xhslink.com/m/Ap1vXtgAixh | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-user-info"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_user_info`
-
-- Summary: 获取用户信息/Get user info
-- Capabilities: profiles / accounts
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_user_info_api_v1_xiaohongshu_app_get_user_info_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取用户详情信息
-> ### 参数:
-> - user_id: 用户ID（必需）
-> ### 返回:
-> - 用户详情数据，包含：
->     - user_id: 用户ID
->     - nickname: 昵称
->     - desc: 个人简介
->     - gender: 性别（0=女，1=男，2=未知）
->     - images: 头像URL
->     - imageb: 背景图URL
->     - red_official_verify_type: 官方认证类型（0=无，1=个人，2=机构）
->     - red_official_verify_show: 是否显示认证标识
->     - level: 等级信息
->         - image: 等级图标URL
->         - name: 等级名称
->     - follows: 关注数
->     - fans: 粉丝数
->     - interaction: 获赞与收藏总数
->     - notes: 笔记数
->     - boards: 专辑数
->     - location: 所在地
->     - collected: 收藏数
->     - liked: 点赞数
->
-> # [English]
-> ### Purpose:
-> - Get user detail info
-> ### Parameters:
-> - user_id: User ID (required)
-> ### Return:
-> - User detail data including:
->     - user_id: User ID
->     - nickname: Nickname
->     - desc: Personal bio
->     - gender: Gender (0=female, 1=male, 2=unknown)
->     - images: Avatar URL
->     - imageb: Background image URL
->     - red_official_verify_type: Official verify type (0=none, 1=personal, 2=organization)
->     - red_official_verify_show: Whether show verify badge
->     - level: Level info
->         - image: Level icon URL
->         - name: Level name
->     - follows: Following count
->     - fans: Fans count
->     - interaction: Total likes & collects
->     - notes: Notes count
->     - boards: Album count
->     - location: Location
->     - collected: Collect count
->     - liked: Like count
->
-> # [示例/Example]
-> user_id="5c2f338a000000000701e1c6"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| user_id | query | string | Yes | 用户ID/User ID | None | 5c2f338a000000000701e1c6 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-get-user-notes"></a>
-### `GET /api/u1/v1/xiaohongshu/app/get_user_notes`
-
-- Summary: 获取用户作品列表/Get user notes
-- Capabilities: profiles / accounts / content details
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `get_user_notes_api_v1_xiaohongshu_app_get_user_notes_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 获取用户发布的笔记列表
-> ### 参数:
-> - user_id: 用户ID（必需）
-> - cursor: 翻页索引，上一次请求返回的cursor字段，不传默认请求第一页
-> - cursor取值方式为notes列表的最后一条笔记的note_id
-> ### 返回:
-> - 用户笔记列表数据，包含：
->     - notes: 笔记数组，每个笔记包含：
->         - note_id: 笔记ID
->         - type: 类型（normal=图文，video=视频）
->         - display_title: 标题
->         - desc: 描述
->         - liked_count: 点赞数
->         - cover: 封面图信息
->             - url: 图片URL
->             - width: 宽度
->             - height: 高度
->         - user: 作者信息（通常与查询用户相同）
->     - cursor: 翻页游标
->     - has_more: 是否有更多数据
->
-> ### 翻页说明:
-> - 首次请求：只传user_id
-> - 翻页请求：传入上一次返回的cursor
-> - 当has_more为false时，表示没有更多笔记
->
-> # [English]
-> ### Purpose:
-> - Get user's published notes list
-> ### Parameters:
-> - user_id: User ID (required)
-> - cursor: Pagination cursor from previous response, omit for first page
-> - Cursor value is the note_id of the last note in the notes list
-> ### Return:
-> - User notes data including:
->     - notes: Notes array, each note contains:
->         - note_id: Note ID
->         - type: Type (normal=image, video=video)
->         - display_title: Title
->         - desc: Description
->         - liked_count: Like count
->         - cover: Cover image info
->             - url: Image URL
->             - width: Width
->             - height: Height
->         - user: Author info (usually same as queried user)
->     - cursor: Pagination cursor
->     - has_more: Whether has more data
->
-> ### Pagination Guide:
-> - First request: Only pass user_id
-> - Next pages: Pass cursor from previous response
-> - When has_more is false, no more notes available
->
-> # [示例/Example]
-> user_id="5c57e6a4000000001802a013"
-> cursor="67ee399f000000001c02f36f"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| user_id | query | string | Yes | 用户ID/User ID | None | 5c57e6a4000000001802a013 | None |
-| cursor | query | string | No | 翻页游标/Pagination cursor | None | 67ee399f000000001c02f36f | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-search-notes"></a>
-### `GET /api/u1/v1/xiaohongshu/app/search_notes`
-
-- Summary: 搜索笔记/Search notes
-- Capabilities: search / content details
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `search_notes_api_v1_xiaohongshu_app_search_notes_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 搜索小红书笔记
-> ### 参数:
-> - keyword: 要搜索的关键词（必需）
-> - page: 第几页，从1开始（必需）
-> - search_id: 搜索ID，第一次请求可不传，服务端会生成searchId，翻页时需要携带服务端返回的searchId
-> - session_id: 会话ID，第一次请求可不传，服务端会生成sessionId，翻页时携带服务端返回的sessionId
-> - sort_type: 排序规则
->     - "general": 综合排序（默认）
->     - "time_descending": 最新发布
->     - "popularity_descending": 最多点赞
->     - "comment_descending": 最多评论
->     - "collect_descending": 最多收藏
-> - filter_note_type: 筛选笔记类型
->     - "不限": 所有类型（默认）
->     - "视频笔记": 仅视频
->     - "普通笔记": 仅图文
-> - filter_note_time: 筛选笔记发布时间
->     - "不限": 所有时间（默认）
->     - "一天内": 24小时内
->     - "一周内": 7天内
->     - "半年内": 6个月内
-> ### 返回:
-> - 搜索结果数据，包含：
->     - items: 搜索结果列表，每个元素包含：
->         - id: 元素ID
->         - model_type: 模型类型（通常为"note"）
->         - note: 笔记详情
->             - note_id: 笔记ID
->             - type: 类型（normal=图文，video=视频）
->             - display_title: 标题（关键词会高亮）
->             - desc: 内容描述（搜索接口无法返回完整的 desc，仅部分内容，请使用笔记详情接口获取完整内容）
->             - user: 作者信息
->             - interact_info: 互动数据
->                 - liked_count: 点赞数
->             - cover: 封面图信息
->     - searchId: 搜索ID（翻页必需，不同关键词不要复用）
->     - sessionId: 会话ID（翻页必需）
->     - has_more: 是否有更多数据
->     - total_count: 搜索结果总数
->
-> ### 翻页说明:
-> - 首次搜索：只传keyword和page=1
-> - 翻页搜索：传入相同keyword，递增page，并携带首次返回的searchId和sessionId
-> - 注意：更换关键词时不要复用之前的searchId
->
-> # [English]
-> ### Purpose:
-> - Search Xiaohongshu notes
-> ### Parameters:
-> - keyword: Search keyword (required)
-> - page: Page number, start from 1 (required)
-> - search_id: Search ID, optional for first request, required for pagination
-> - session_id: Session ID, optional for first request, required for pagination
-> - sort_type: Sort method
->     - "general": Comprehensive (default)
->     - "time_descending": Latest published
->     - "popularity_descending": Most liked
->     - "comment_descending": Most commented
->     - "collect_descending": Most collected
-> - filter_note_type: Note type filter
->     - "不限": All types (default)
->     - "视频笔记": Video only
->     - "普通笔记": Image & text only
-> - filter_note_time: Time filter
->     - "不限": All time (default)
->     - "一天内": Within 24 hours
->     - "一周内": Within 7 days
->     - "半年内": Within 6 months
-> ### Return:
-> - Search results data containing:
->     - items: Search results list, each element includes:
->         - id: Element ID
->         - model_type: Model type (usually "note")
->         - note: Note details
->             - note_id: Note ID
->             - type: Type (normal=image, video=video)
->             - display_title: Title (keywords highlighted)
->             - desc: Content description (incomplete in search results, use note detail API for full content)
->             - user: Author info
->             - interact_info: Interaction data
->                 - liked_count: Like count
->             - cover: Cover image info
->     - searchId: Search ID (required for pagination, don't reuse for different keywords)
->     - sessionId: Session ID (required for pagination)
->     - has_more: Whether has more data
->     - total_count: Total search results count
->
-> ### Pagination Guide:
-> - First search: Only pass keyword and page=1
-> - Next pages: Pass same keyword, increment page, include searchId and sessionId from first response
-> - Note: Don't reuse searchId when changing keywords
->
-> # [示例/Example]
-> keyword="猫粮"
-> page=1
-> sort_type="general"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| keyword | query | string | Yes | 搜索关键词/Search keyword | None | 猫粮 | None |
-| page | query | integer | Yes | 页码（从1开始）/Page number (start from 1) | None | 1 | None |
-| search_id | query | string | No | 搜索ID，翻页时使用/Search ID for pagination | None | 2egvdsiowvfm9thbt260w | None |
-| session_id | query | string | No | 会话ID，翻页时使用/Session ID for pagination | None | 2egvdt4sl2b7rnfg8zk00 | None |
-| sort_type | query | string | No | 排序方式/Sort type | general | general | None |
-| filter_note_type | query | string | No | 笔记类型筛选：不限、视频笔记、普通笔记/Note type filter | 不限 | 不限 | None |
-| filter_note_time | query | string | No | 发布时间筛选：不限、一天内、一周内、半年内/Time filter | 不限 | 不限 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |
-
-<a id="get-api-u1-v1-xiaohongshu-app-search-products"></a>
-### `GET /api/u1/v1/xiaohongshu/app/search_products`
-
-- Summary: 搜索商品/Search products
-- Capabilities: search / commerce
-- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
-- operationId: `search_products_api_v1_xiaohongshu_app_search_products_get`
-
-#### Notes
-
-> # [中文]
-> ### 用途:
-> - 搜索小红书商品
-> ### 参数:
-> - keyword: 搜索关键词（必需）
-> - page: 页码，从1开始（必需）
-> - search_id: 搜索ID，第一次请求可不传，翻页时需要携带服务端返回的searchId
-> - session_id: 会话ID，第一次请求可不传，翻页时携带服务端返回的sessionId
-> - sort: 排序规则，默认综合
->     - "sales_qty": 销量
->     - "price_asc": 价格升序
->     - "price_desc": 价格降序
-> - scope: 搜索范围，默认不限
->     - "purchased": 买过的店
->     - "following": 关注的店
-> - service_guarantee: 物流权益，多选用英文逗号分割
->     - 可选值: "24小时发货", "七天无理由", "现货", "退货包运费"
-> - min_price: 最低价
-> - max_price: 最高价
-> - super_promotion: 标签ID
-> ### 返回:
-> - 搜索结果数据，包含：
->     - items: 商品列表
->     - searchId: 搜索ID（翻页必需）
->     - sessionId: 会话ID（翻页必需）
->     - has_more: 是否有更多数据
->
-> ### 翻页说明:
-> - 首次搜索：只传keyword和page=1
-> - 翻页搜索：传入相同keyword，递增page，并携带首次返回的searchId和sessionId
-> - 注意：更换关键词时不要复用之前的searchId
->
-> # [English]
-> ### Purpose:
-> - Search Xiaohongshu products
-> ### Parameters:
-> - keyword: Search keyword (required)
-> - page: Page number, start from 1 (required)
-> - search_id: Search ID, optional for first request, required for pagination
-> - session_id: Session ID, optional for first request, required for pagination
-> - sort: Sort method
->     - "sales_qty": By sales
->     - "price_asc": Price ascending
->     - "price_desc": Price descending
-> - scope: Search scope
->     - "purchased": Shops you've bought from
->     - "following": Shops you follow
-> - service_guarantee: Service guarantees, comma separated
->     - Options: "24小时发货", "七天无理由", "现货", "退货包运费"
-> - min_price: Minimum price
-> - max_price: Maximum price
-> - super_promotion: Promotion tag ID
-> ### 返回:
-> - Search results containing:
->     - items: Product list
->     - searchId: Search ID (required for pagination)
->     - sessionId: Session ID (required for pagination)
->     - has_more: Whether has more data
->
-> ### Pagination Guide:
-> - First search: Only pass keyword and page=1
-> - Next pages: Pass same keyword, increment page, include searchId and sessionId
-> - Note: Don't reuse searchId when changing keywords
->
-> # [示例/Example]
-> keyword="充电宝"
-> page=1
-> sort="sales_qty"
-
-#### Parameters
-
-| Field | In | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| keyword | query | string | Yes | 搜索关键词/Search keyword | None | 充电宝 | None |
-| page | query | integer | Yes | 页码（从1开始）/Page number (start from 1) | None | 1 | None |
-| search_id | query | string | No | 搜索ID，翻页时使用/Search ID for pagination | None | None | None |
-| session_id | query | string | No | 会话ID，翻页时使用/Session ID for pagination | None | None | None |
-| sort | query | string | No | 排序规则：sales_qty-销量、price_asc-价格升序、price_desc-价格降序/Sort: sales_qty, price_asc, price_desc | None | sales_qty | None |
-| scope | query | string | No | 搜索范围：purchased-买过的店、following-关注的店/Scope: purchased, following | None | purchased | None |
-| service_guarantee | query | string | No | 物流权益，多选用英文逗号分割/Service guarantee, comma separated | None | 24小时发货,七天无理由 | None |
-| min_price | query | string | No | 最低价/Min price | None | 1 | None |
-| max_price | query | string | No | 最高价/Max price | None | 100 | None |
-| super_promotion | query | string | No | 标签ID/Promotion tag ID | None | 695fb0a330425100017ff555 | None |
-
-#### Request Body
-
-None
-
-#### Success Response
-
-##### `200 application/json`
-
-- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
-
-| Field | Type | Required | Description | Default | Example | Enum |
-| --- | --- | --- | --- | --- | --- | --- |
-| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
-| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
-| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
-| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
-| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
-| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
-| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
-| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
-| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
-| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
-| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
-| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
-| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
-| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
-| data | null | No | The response data \| 响应数据 | None | None | None |