--- title: "获取视频笔记详情/Get video note detail" method: GET path: "/api/v1/xiaohongshu/app_v2/get_video_note_detail" tags: ["Xiaohongshu-App-V2-API"] --- # 获取视频笔记详情/Get video note detail `GET /api/v1/xiaohongshu/app_v2/get_video_note_detail` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/xiaohongshu/app_v2/get_video_note_detail` - Auth: HTTP bearer # [中文] ### 用途: - 获取视频笔记的完整详情数据 ### ⚠️ 笔记类型说明（重要）: - 小红书笔记分为两种类型：`图文笔记（normal）` 和 `视频笔记（video）`，使用时务必区分。 - 本接口 **只能获取视频笔记的数据**，如果传入图文笔记的 note_id 将无法请求到内容，此限制来自小红书官方。 - 图文笔记接口 `/get_image_note_detail` 可以获取图文和视频两种笔记，但对视频笔记不会返回视频文件的播放链接，只会返回视频封面图。 ### 推荐调用流程（不确定笔记类型时）: - 1. 优先请求 `/get_image_note_detail`（图文笔记接口）。 - 2. 通过响应中的笔记类型字段（如 `type` 是否为 `video`）判断是否为视频笔记。 - 3. 如果是视频笔记，再使用相同的 note_id 请求本接口获取视频播放地址。 ### ⚠️ 计费提示: - 如果传入错误或不存在的笔记ID（或分享链接解析失败），接口仍会正常响应，但 `data` 中会返回上游"服务异常"信息，该请求 **同样会正常计费扣费**，请在调用前确保参数有效。 ### 参数: - note_id: 笔记ID，如 "697c0eee000000000a03c308" - share_text: 小红书分享链接，支持APP和Web端分享链接，支持 `xiaohongshu.com` 长链接、`xhslink.com` 和 `xhslink.cn` 短链接 - 优先使用`note_id`，如果没有则使用`share_text`，两个参数二选一，如都携带则以`note_id`为准。 ### 返回: - 视频笔记详情数据，包含视频播放地址、封面图、作者信息、互动数据等 # [English] ### Purpose: - Get full detail data of a video note ### ⚠️ Note Type Notice (Important): - Xiaohongshu notes come in two types: `image notes (normal)` and `video notes (video)`. Make sure to distinguish them when using the APIs. - This endpoint can **ONLY fetch data of video notes**. Passing the note_id of an image note will fail to get any content. This restriction comes from Xiaohongshu official. - The image note endpoint `/get_image_note_detail` can fetch both image and video notes, but for video notes it will NOT return the video play URL, only the video cover image. ### Recommended Workflow (when note type is unknown): - 1. Request `/get_image_note_detail` (image note endpoint) first. - 2. Check the note type field in the response (e.g. whether `type` is `video`) to determine if it is a video note. - 3. If it is a video note, request this endpoint again with the same note_id to get the video play URL. ### ⚠️ Billing Notice: - If a wrong or non-existent note ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream "service error" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling. ### Parameters: - note_id: Note ID, e.g. "697c0eee000000000a03c308" - share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links - 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: - Video note detail data, including video play URL, cover image, author info, interaction data, etc. # [示例/Example] note_id="697c0eee000000000a03c308" ## Query parameters - `note_id` string: 笔记ID/Note ID - `share_text` string: 分享链接，支持xiaohongshu.com/xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/xiaohongshu/app_v2/get_video_note_detail/get.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)