--- title: "搜索笔记/Search notes" method: GET path: "/api/v1/xiaohongshu/app_v2/search_notes" tags: ["Xiaohongshu-App-V2-API"] --- # 搜索笔记/Search notes `GET /api/v1/xiaohongshu/app_v2/search_notes` ## 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/search_notes` - Auth: HTTP bearer # [中文] ### 用途: - 根据关键词搜索小红书笔记，支持多种排序方式、笔记类型筛选和发布时间筛选 ### 参数: - keyword: 搜索关键词（必需），如 "美食推荐" - page: 页码，从 1 开始 - sort_type: 排序方式 - "general": 综合排序（默认） - "time_descending": 按时间倒序（最新） - "popularity_descending": 按点赞数排序（最多点赞） - "comment_descending": 按评论数排序（最多评论） - "collect_descending": 按收藏数排序（最多收藏） - "english_preferred": 英文优先 - note_type: 笔记类型筛选 - "不限": 所有类型（默认） - "视频笔记": 仅视频 - "普通笔记": 仅图文 - "直播笔记": 仅直播 - time_filter: 发布时间筛选 - "不限": 所有时间（默认） - "一天内": 24小时内 - "一周内": 7天内 - "半年内": 6个月内 - search_id: 搜索ID，翻页时传入首次搜索返回的值 - search_session_id: 搜索会话ID，翻页时传入首次搜索返回的值 - source: 来源，默认 "explore_feed" - ai_mode: AI模式，0=关闭, 1=开启 ### 返回: - 搜索结果数据，包含笔记列表和分页信息 ### 翻页说明: - 首次请求：只传keyword和page - 翻页请求：传入首次搜索返回的 search_id 和 search_session_id # [English] ### Purpose: - Search Xiaohongshu notes by keyword, supports multiple sort types, note type filters, and time filters ### Parameters: - keyword: Search keyword (required), e.g. "美食推荐" - page: Page number, start from 1 - sort_type: Sort type - "general": General sort (default) - "time_descending": Sort by time descending (latest) - "popularity_descending": Sort by like count (most liked) - "comment_descending": Sort by comment count (most commented) - "collect_descending": Sort by collect count (most collected) - "english_preferred": English preferred - note_type: Note type filter - "不限": All types (default) - "视频笔记": Video notes only - "普通笔记": Image notes only - "直播笔记": Live notes only - time_filter: Time filter - "不限": All time (default) - "一天内": Within 24 hours - "一周内": Within 7 days - "半年内": Within 6 months - search_id: Search ID, pass value from first search response for pagination - search_session_id: Search session ID, pass value from first search response for pagination - source: Source, default "explore_feed" - ai_mode: AI mode, 0=off, 1=on ### Return: - Search result data, including note list and pagination info ### Pagination Guide: - First request: only pass keyword and page - Next page: pass search_id and search_session_id from first search response # [示例/Example] keyword="美食推荐" page=1 sort_type="general" ## Query parameters - `keyword` string, required: 搜索关键词/Search keyword - `page` integer: 页码，从1开始/Page number, start from 1 - `sort_type` string: 排序方式/Sort type - `note_type` string: 笔记类型/Note type: 不限, 视频笔记, 普通笔记, 直播笔记 - `time_filter` string: 发布时间筛选/Time filter: 不限, 一天内, 一周内, 半年内 - `search_id` string: 搜索ID，翻页时传入首次搜索返回的值/Search ID for pagination - `search_session_id` string: 搜索会话ID，翻页时传入首次搜索返回的值/Search session ID for pagination - `source` string: 来源/Source - `ai_mode` integer: AI模式：0=关闭, 1=开启/AI mode: 0=off, 1=on ## 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/search_notes/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)