搜索笔记

按关键词搜索小红书笔记。

文档 ID: agent.collection.task.xhs_search_notes_v1

输入

keyword必填 · text

关键词

默认:

page必填 · integer

页码

默认: 1

sort_type可选 · select

排序

默认: general · 允许值: general, time_descending, popularity_descending

note_type可选 · select

内容类型

默认: 普通笔记 · 允许值: 普通笔记, 视频笔记

note_time可选 · select

时间范围

默认: 一周内 · 允许值: 一天内, 一周内, 半年内

最小调用

estimate_collection

{
  "input": {
    "keyword": "防晒",
    "page": 1
  },
  "task_code": "xhs_search_notes_v1",
  "task_query": "搜索小红书上关于防晒的笔记"
}

结果与分页

mode: page
data.page → data.max_pages
每个成功任务 10 Credits；预计 5–30 秒。

只有下方列出的字段属于稳定结果契约。

路径	类型	说明
`meta.request_id`	`string`	用于追踪的 Asklear 请求 ID。
`meta.api_name`	`string`	实际执行的采集操作名称。
`meta.latency_ms`	`integer`	采集执行耗时（毫秒）。
`meta.credits_charged`	`integer`	任务完成后 Asklear 用户侧实际结算的 Credits。
`data.entity`	`string`	响应实体类型。
`data.keyword`	`string`	本次提交的搜索关键词。
`data.page`	`integer`	当前结果页码。
`data.max_pages`	`integer`	下一页提示；仍有 items 返回时可请求下一页。
`data.item_count`	`integer`	本页返回的条目数。
`data.items`	`array<object>`	本页搜索到的笔记列表。
`data.items[].note_id`	`string`	笔记 ID。
`data.items[].title`	`string`	笔记标题。
`data.items[].description`	`string`	笔记描述或摘要。
`data.items[].note_type`	`string`	笔记类型。
`data.items[].publish_time`	`integer`	发布时间戳。
`data.items[].liked_count`	`integer`	点赞数。
`data.items[].collected_count`	`integer`	收藏数。
`data.items[].comments_count`	`integer`	评论数。
`data.items[].images`	`array<object>`	笔记配图列表。
`data.items[].images[].file_id`	`string`	图片文件 ID。
`data.items[].images[].url`	`string`	图片 URL。
`data.items[].images[].large_url`	`string`	大图 URL（如响应提供）。
`data.items[].images[].width`	`integer`	图片宽度（像素）。
`data.items[].images[].height`	`integer`	图片高度（像素）。
`data.items[].author`	`object`	笔记作者摘要。
`data.items[].author.user_id`	`string`	作者用户 ID。
`data.items[].author.red_id`	`string`	作者平台 ID。
`data.items[].author.nickname`	`string`	作者昵称。
`data.items[].author.avatar`	`string`	作者头像 URL。
`data.items[].author.verified`	`boolean`	作者是否认证。
`data.items[].author.verify_type`	`integer`	认证类型编码。