---
document_id: agent.collection.task.xhs_search_notes_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Search notes / 搜索笔记

Search Xiaohongshu notes by keyword, paging through the results. For one note's body use xhs_note_detail_v1.

按关键词搜索小红书笔记,按页翻页返回笔记列表。要取某篇笔记的正文用 xhs_note_detail_v1。

Task / 任务: `xhs_search_notes_v1`
Platform / 平台: Xiaohongshu / 小红书
Billing / 计费: 10 Credits per successful task / 每个成功任务 10 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Inputs / 输入

- `keyword` — Keyword / 关键词; kind=text; required=True; default=''; bounds=min_length=1, max_length=200
- `page` — Page / 页码; kind=integer; required=True; default=1; bounds=min=1, max=20
- `sort_type` — Sort / 排序; kind=select; required=False; default='general'; allowed=general, time_descending, popularity_descending
- `note_type` — Note type / 内容类型; kind=select; required=False; default='普通笔记'; allowed=普通笔记, 视频笔记
- `note_time` — Time range / 时间范围; kind=select; required=False; default='一周内'; allowed=一天内, 一周内, 半年内

## Minimal call / 最小调用

`estimate_collection`

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


## Result and pagination / 结果与分页

- mode=page
- current page: `data.page`; next-page hint: `data.max_pages`

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.entity` — type=string; Response entity type. / 响应实体类型。
- `data.keyword` — type=string; The submitted search keyword. / 本次提交的搜索关键词。
- `data.page` — type=integer; Current result page. / 当前结果页码。
- `data.max_pages` — type=integer; Next-page hint; request the next page while items continue to be returned. / 下一页提示；仍有 items 返回时可请求下一页。
- `data.item_count` — type=integer; Number of items in this response page. / 本页返回的条目数。
- `data.items` — type=array<object>; Search result notes for this page. / 本页搜索到的笔记列表。
- `data.items[].note_id` — type=string; Note identifier. / 笔记 ID。
- `data.items[].title` — type=string; Note title. / 笔记标题。
- `data.items[].description` — type=string; Note description or excerpt. / 笔记描述或摘要。
- `data.items[].note_type` — type=string; Note type. / 笔记类型。
- `data.items[].publish_time` — type=integer; Publish timestamp. / 发布时间戳。
- `data.items[].liked_count` — type=integer; Like count. / 点赞数。
- `data.items[].collected_count` — type=integer; Collection count. / 收藏数。
- `data.items[].comments_count` — type=integer; Comment count. / 评论数。
- `data.items[].images` — type=array<object>; Images attached to the note. / 笔记配图列表。
- `data.items[].images[].file_id` — type=string; Image file identifier. / 图片文件 ID。
- `data.items[].images[].url` — type=string; Image URL. / 图片 URL。
- `data.items[].images[].large_url` — type=string; Large image URL, when supplied. / 大图 URL（如响应提供）。
- `data.items[].images[].width` — type=integer; Image width in pixels. / 图片宽度（像素）。
- `data.items[].images[].height` — type=integer; Image height in pixels. / 图片高度（像素）。
- `data.items[].author` — type=object; Note author summary. / 笔记作者摘要。
- `data.items[].author.user_id` — type=string; Author user identifier. / 作者用户 ID。
- `data.items[].author.red_id` — type=string; Author platform identifier. / 作者平台 ID。
- `data.items[].author.nickname` — type=string; Author nickname. / 作者昵称。
- `data.items[].author.avatar` — type=string; Author avatar URL. / 作者头像 URL。
- `data.items[].author.verified` — type=boolean; Whether the author is verified. / 作者是否认证。
- `data.items[].author.verify_type` — type=integer; Verification type code. / 认证类型编码。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。