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

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

# User notes / 用户笔记

Fetch one Xiaohongshu user's publicly posted notes by exact user_id. To find notes by keyword use xhs_search_notes_v1.

取某个小红书用户公开发布的笔记列表,需要精确 user_id。要按关键词找笔记用 xhs_search_notes_v1。

Task / 任务: `xhs_user_notes_v1`
Platform / 平台: Xiaohongshu / 小红书
Billing / 计费: 8 Credits per successful task / 每个成功任务 8 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`。

## Limitations / 限制

- 只接受精确 user_id,不支持按昵称查找用户。
- 只返回公开笔记,不含私密或已删除内容。

## Inputs / 输入

- `user_id` — User ID / 用户 ID; kind=text; required=True; default=''; bounds=min_length=1, max_length=128
- `cursor` — Cursor / 游标; kind=cursor; required=False; default=''; bounds=max_length=512

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "获取指定小红书用户发布的笔记",
  "task_code": "xhs_user_notes_v1",
  "input": {
    "user_id": "<搜索结果返回的 user_id>"
  }
}
```


## Result and pagination / 结果与分页

- mode=cursor
- input: `cursor`; continuation: `data.has_more` → `data.next_cursor`

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.has_more` — type=boolean; Whether another user-note page is available. / 是否还有下一页用户笔记。
- `data.next_cursor` — type=string; Cursor for the next page when has_more is true. / has_more 为 true 时用于请求下一页的游标。
- `data.item_count` — type=integer; Number of notes in this response, when supplied. / 本次返回的笔记数（如响应提供）。
- `data.items` — type=array<object>; User-note items for this page, when supplied. / 本页用户笔记条目（如响应提供）。
- `data.items[].note_id` — type=scalar|null; Note id, when available. / 笔记ID（如有）。
- `data.items[].title` — type=scalar|null; Title, when available. / 标题（如有）。
- `data.items[].description` — type=scalar|null; Description, when available. / 描述（如有）。
- `data.items[].note_type` — type=scalar|null; Note type, when available. / 笔记类型（如有）。
- `data.items[].liked_count` — type=scalar|null; Liked count, when available. / 点赞数（如有）。
- `data.items[].collected_count` — type=scalar|null; Collected count, when available. / 收藏数（如有）。
- `data.items[].comments_count` — type=scalar|null; Comments count, when available. / 评论数（如有）。
- `data.items[].share_count` — type=scalar|null; Share count, when available. / 分享数（如有）。
- `data.items[].view_count` — type=scalar|null; View count, when available. / 浏览数（如有）。
- `data.items[].ip_location` — type=scalar|null; Ip location, when available. / IP地点（如有）。
- `data.items[].publish_time` — type=scalar|null; Publish time, when available. / 发布时间（如有）。
- `data.items[].last_update_time` — type=scalar|null; Last update time, when available. / 最近更新时间（如有）。
- `data.entity` — type=string; Published result entity type. / 公开结果实体类型。
- `data.items[].author` — type=object|null; Public author summary. / 公开作者信息摘要。
- `data.items[].author.user_id` — type=scalar|null; User id, when available. / 用户ID（如有）。
- `data.items[].author.nickname` — type=scalar|null; Display name, when available. / 昵称（如有）。
- `data.items[].author.avatar` — type=scalar|null; Avatar, when available. / 头像（如有）。
- `data.items[].author.verify_type` — type=scalar|null; Verify type, when available. / 认证类型（如有）。
- `data.items[].images` — type=array<object>; Note images. / 笔记配图。
- `data.items[].images[].file_id` — type=scalar|null; File id, when available. / fileID（如有）。
- `data.items[].images[].url` — type=scalar|null; Public URL, when available. / 公开链接（如有）。
- `data.items[].images[].large_url` — type=scalar|null; Large url, when available. / large链接（如有）。
- `data.items[].images[].width` — type=scalar|null; Width, when available. / 宽度（如有）。
- `data.items[].images[].height` — type=scalar|null; Height, when available. / 高度（如有）。

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 控制。