Xiaohongshu Note Search
Search Xiaohongshu image and video notes, excluding ads and preserving all source images and videos. Only note search is currently available; product and group endpoints are not available. Returns one page at a time.
Start with your agent
Download and install the dedicated Mouter Skill for “Xiaohongshu Note Search”: https://mouter.ai/skills/xiaohongshu_category_search.zip
Pricing
0.01 credits per call
Each additional page is billed as a separate call.
Usage example
Agent
Example input
Use xiaohongshu_category_search. Look up Xiaohongshu Note Search using query travel guide and summarize matching content, sources and pagination. Confirm inputs and estimated cost before running.
Example output
Example only: Xiaohongshu Note Search has not been run. Once a task succeeds, its result contains these fields:
- publish_timetext
- platformtext
- querytext
- note_typetext
- published_withintext
- itemslist: audio_tracks, music, topics, id, url
- returned_countnumber
- paginationobject: has_more, next_cursor, total
Values depend on your input. The matching JSON example structure is in the API tab.
Continue this example
For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch. Illustrative requests and response fragment; no calls are executed.
1. Initial request
{
"name": "xiaohongshu_category_search",
"arguments": {
"query": "travel guide"
}
}2. Returned continuation
{
"pagination": {
"next_cursor": "<NEXT_CURSOR>",
"has_more": true
}
}3. Follow-up request
{
"name": "xiaohongshu_category_search",
"arguments": {
"query": "travel guide",
"cursor": "<NEXT_CURSOR>"
}
}- Getting started: provide search term. Adjust continuation cursor, note type, publication range as needed.
FAQ
How do I search by keyword with Xiaohongshu Note Search?
Xiaohongshu Note Search: Getting started: provide search term. Adjust continuation cursor, note type, publication range as needed. query: 1–512 characters Illustrative values on this page: query="travel guide".
Which result details can I use from Xiaohongshu Note Search?
Search Xiaohongshu image and video notes, excluding ads and preserving all source images and videos. Only note search is currently available; product and group endpoints are not available. Returns one page at a time. The result includes publish_time, query, note_type, published_within, items, returned_count, pagination. Read result.items[]: id, url, title, text, content_html, author, published_at, published_at_text, cover_url, media. result.retrieved_at records retrieval time; content publication times are separate source fields. Optional fields depend on what the source returns; retain null or missing values when combining results.
How do I choose note_type / published_within for Xiaohongshu Note Search?
Xiaohongshu Note Search: note_type: values all / image / video; default "all" · published_within: values all / day / week / half_year; default "all".
How do I retrieve more results from Xiaohongshu Note Search?
Xiaohongshu Note Search: For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch.
How is Xiaohongshu Note Search billed for each request?
Published reference rates: Standard rate: 0.01 credits · Per call. Each additional page is billed as a separate call. Final charges use your account’s rates and actual usage.