Xiaohongshu (RedNote) Product / Mall Scraper

Scrape Xiaohongshu mall (小红书商城) products by keyword search — or fetch full detail for specific product / SKU IDs. Returns clean, structured data per product: price, original price, vendor / seller, stock status, SKU count, category, images and the product URL. A companion to the RedNote note scraper.

Unofficial. This Actor is not affiliated with, authorized, or endorsed by Xiaohongshu (Xingin / 行吟信息科技). It is an independent tool that retrieves publicly available data via a third-party API. Use it in compliance with Xiaohongshu's terms and all applicable laws; you are responsible for how you use the retrieved data.

What it does

• Keyword search — give one or more keywords; the Actor paginates the Xiaohongshu mall for each (~20 rich product cards per page). Sort by comprehensive / price / best-selling and optionally filter by a min/max price range.
• Product detail (optional) — give one or more product (SKU) IDs to fetch full detail, including the per-color/variant SKU list and product images.

Input

Field	Type	Default	Description
searchKeywords	string[]	["口红"]	Keywords to search the mall for. Each is paginated independently. Chinese keywords return the most products.
skuIds	string[]	[]	Specific product / SKU IDs to fetch full detail for (e.g. 6a12b66ac0b0790015bbd209).
maxItems	integer	50	Max total products across all keywords and SKU IDs.
sort	enum	general	general / price_ascending / price_descending / sale_descending.
minPrice	string	""	Optional min price (CNY 元) for keyword search.
maxPrice	string	""	Optional max price (CNY 元) for keyword search.

Example input

{
  "searchKeywords": ["口红", "连衣裙"],
  "maxItems": 100,
  "sort": "sale_descending",
  "minPrice": "50",
  "maxPrice": "300"
}

Output

One dataset item per product:

{
  "productId": "6a12b66ac0b0790015bbd209",
  "url": "https://www.xiaohongshu.com/goods-detail/6a12b66ac0b0790015bbd209",
  "title": "Black Magic Secret Long-Lasting Moisturizing Waterproof Lipstick",
  "price": 8.84,
  "originPrice": 10.4,
  "foreignPrice": "≈£0.99",
  "currency": "CNY",
  "vendorName": "维怡美斑痘敏总站～怀化店的店",
  "sellerId": "66a2fc06bd86ee0015314415",
  "vendorType": "INDIVIDUAL_NEW",
  "stockStatus": 1,
  "inStock": true,
  "goodsType": "normal",
  "goodsCategory": "化妆/美容工具",
  "skuCount": 5,
  "coverUrl": "https://mall-i10.xhscdn.com/material_space/...",
  "imageUrls": ["https://..."],
  "source": "search:口红"
}

Product-detail items additionally include a skus array (one entry per color/variant with skuId, value, imageUrl and variants).

Notes

• Data is sourced live; the mall occasionally rate-limits, so the Actor retries transient blocks with exponential backoff.
• Product IDs are de-duplicated within a run.
• Prices are in CNY (元). price reflects the current/discounted price; originPrice the list price.