Search notes

Search Xiaohongshu notes by keyword.

Document ID: agent.collection.task.xhs_search_notes_v1

Inputs

keywordRequired · text

Keyword

Default:

pageRequired · integer

Page

Default: 1

sort_typeOptional · select

Sort

Default: general · Allowed: general, time_descending, popularity_descending

note_typeOptional · select

Note type

Default: 普通笔记 · Allowed: 普通笔记, 视频笔记

note_timeOptional · select

Time range

Default: 一周内 · Allowed: 一天内, 一周内, 半年内

Minimal call

estimate_collection

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

Result and pagination

mode: page
data.page → data.max_pages
10 Credits per successful task; estimated 5–30 seconds.

Only the fields listed below are part of the stable result contract.

Path	Type	Description
`meta.request_id`	`string`	Asklear request identifier for tracing.
`meta.api_name`	`string`	Executed collection operation name.
`meta.latency_ms`	`integer`	Collection execution latency in milliseconds.
`meta.credits_charged`	`integer`	Asklear user-side Credits settled for this task after completion.
`data.entity`	`string`	Response entity type.
`data.keyword`	`string`	The submitted search keyword.
`data.page`	`integer`	Current result page.
`data.max_pages`	`integer`	Next-page hint; request the next page while items continue to be returned.
`data.item_count`	`integer`	Number of items in this response page.
`data.items`	`array<object>`	Search result notes for this page.
`data.items[].note_id`	`string`	Note identifier.
`data.items[].title`	`string`	Note title.
`data.items[].description`	`string`	Note description or excerpt.
`data.items[].note_type`	`string`	Note type.
`data.items[].publish_time`	`integer`	Publish timestamp.
`data.items[].liked_count`	`integer`	Like count.
`data.items[].collected_count`	`integer`	Collection count.
`data.items[].comments_count`	`integer`	Comment count.
`data.items[].images`	`array<object>`	Images attached to the note.
`data.items[].images[].file_id`	`string`	Image file identifier.
`data.items[].images[].url`	`string`	Image URL.
`data.items[].images[].large_url`	`string`	Large image URL, when supplied.
`data.items[].images[].width`	`integer`	Image width in pixels.
`data.items[].images[].height`	`integer`	Image height in pixels.
`data.items[].author`	`object`	Note author summary.
`data.items[].author.user_id`	`string`	Author user identifier.
`data.items[].author.red_id`	`string`	Author platform identifier.
`data.items[].author.nickname`	`string`	Author nickname.
`data.items[].author.avatar`	`string`	Author avatar URL.
`data.items[].author.verified`	`boolean`	Whether the author is verified.
`data.items[].author.verify_type`	`integer`	Verification type code.