[中文]

用途:

搜索小红书笔记

参数:

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"

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

搜索笔记/Search notes

[中文]

用途:

参数:

返回:

翻页说明:

[English]

Purpose:

Parameters:

Return:

[示例/Example]

Request

Request Code Samples

Responses

搜索笔记/Search notes

[中文]#

用途:#

参数:#

返回:#

翻页说明:#

[English]#

Purpose:#

Parameters:#

Return:#

Pagination Guide:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回:

翻页说明:

[English]

Purpose:

Parameters:

Return:

Pagination Guide:

[示例/Example]