COMMERCE PACK
Product search, details and reviews
Research Xiaohongshu products with explicit SKU-based calls.
Enable product research
Enable Commerce on your Key. For MCP, add packs=commerce to the connection. Each tool supports Xiaohongshu and makes one paid request; it does not buy products or fetch additional pages automatically.
Search, select a SKU, read reviews
Call product_search with platform=xiaohongshu and query. Copy an item's id into product for product_detail and product_reviews. Product IDs are 24-character lowercase hexadecimal SKU references; URLs and guessed SPU identifiers are not accepted.
For another page, pass page.cursor with the same original query or product and filters. Each explicit page has its own call price. Results are limited to one native page, at most 20 products or reviews, and 250 pages.
{
"platform": "xiaohongshu",
"query": "phone case"
}Keep prices and currencies separate
Search native_price already uses major units. Detail native_price converts the source's minor amount by dividing by 100 and retains the original source amount. The source does not establish a native currency. A verified regional display_price has its own currency and must not be treated as the native amount.
Zero or missing prices are unavailable quotes, not free products. Stock is a source snapshot, not an ordering guarantee. Detail variants are source-selected; each variant SKU requires a separate explicit detail request. No whole-SPU completeness is promised.
Choose review order and photo filter
product_reviews accepts sort=general|latest and photo_filter=all|photos. Defaults are general and all. Reviews with photos but no text are retained as Product review. The API omits buyer identities, media URLs, order details and automatic sub-review retrieval.
Relative dates stay source_date_text; an omitted year is not filled in. Reviews are a source-selected sample, not a verified measure of all purchases. A response without an independent SKU echo is explicitly bound to the request metadata. A valid empty page is billable; failed or invalid pages are free.
{
"platform": "xiaohongshu",
"product": "PASTE_RETURNED_SKU_ID",
"sort": "latest",
"photo_filter": "photos"
}API call prices
Price version: standard-2026-09-08-12ebeeeacfa39f97. Use Idempotency-Key for HTTP calls; identical replays keep the original result and charge.
| Platform | Operation | Credits |
|---|---|---|
| Xiaohongshu | product_search | 1.5 |
| Xiaohongshu | product_detail | 1.5 |
| Xiaohongshu | product_reviews | 1.5 |