Xiaohongshu Shop API (小红书商城)

Also known as小红书商品小红书电商xhs shoprednote shop

3 endpoints read Xiaohongshu Shop (小红书商城): product search, product details, buyer reviews. $0.0200 a call. No Xiaohongshu login and no cookie; a failed call is free.

Run it in the PlaygroundUse it in your AISign in to run it. Free trial, no card.
Endpoints3 endpointsproduct search, product details, buyer reviews
PriceFrom $0.0200per call. Failed calls are free
When an upstream failsRetried for youon the same route, or a backup route; never charged
UpdatesLivefetched at the moment of the call

What you get

The first 2 rows of a response recorded 2026-10-12 21:55 UTC. Xiaohongshu product search API →

FieldValue
price17.9
metrics.sold4,027

What this data is

Xiaohongshu's shop is the shop side of Xiaohongshu (RedNote), with prices in yuan. These endpoints search its products by terms, read one product by its ID and read the first page of a product's buyer reviews.

The answers are the same Product and Review objects as TikTok Shop's. A product's id is 24 hexadecimal characters; search results give it, and it goes unchanged to the detail and the reviews.

Prices in yuan
price and original_price are the platform's own prices in CNY, as currency says; original_price is null when there is no discount.
Sold, sometimes a lower bound
metrics.sold is the count shown. From ten thousand up the platform shows a rounded figure such as 11.4k+: it comes back as 11400, and the item's approximate marks it a lower bound.
Search card or product page
A search result has the title as its card words it and one picture. The detail has the page's title, every picture, the description, the rating and the number of reviews.
Review time as shown
A review's time comes only as the app shows it, in ext.date_shown: a date, a month and a day without the year, or how long ago. There is no published_at.
A recorded response
{
  "code": "ok",
  "request_id": "1057f8a1-fd9b-4c22-8a64-0b39cef3c0ca",
  "data": {
    "items": [
      {
        "id": "607f46a700000000d2ac43b7",
        "title": "防晒霜装备清单,新手照着买就行",
        "price": "17.9",
        "original_price": null,
        "currency": "CNY",
        "images": [
          "https://sns-webpic-qc.xhscdn.com/20261015/d34e2e29ca04742dcce6!nd_dft_wlteh_webp_3"
        ],
        "metrics": { "sold": 4027 },
        "shop": { "id": "61f3eff20000000059f57a3b", "name": "木与光家居店" }
      },
      // … 18 more
    ]
  },
  "page": {
    "next_cursor": "c1.U7GaOWwl4KEr-8bH3IgJ8L9E0bROr0O-MTl8yQHt",
    "cursor_expires_at": "2026-10-12T22:55:07.000Z",
    "has_more": true,
    "returned": 19
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.shop.products.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:55:07.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "url": "capability",
      "description": "capability",
      "rating": "capability",
      "metrics.reviews": "capability"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

From a response recorded 2026-10-12 21:55 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

Xiaohongshu product search API · This example as a JSON file

The 3 endpoints

Each row is an endpoint: what it returns and what one call costs.

EndpointPathReturnsPrice
Xiaohongshu product searchGET/v1/xiaohongshu/shop/products/searchProduct list$0.0200
Xiaohongshu product detailGET/v1/xiaohongshu/shop/products/getProduct$0.0200
Xiaohongshu product reviewsGET/v1/xiaohongshu/shop/products/reviews/listReview list$0.0200
Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.See live status →

A typical use, with its bill

Read what buyers say about a kind of product. Search one keyword, then read the details and the first page of reviews of five products.

CallTimesCost
Xiaohongshu product search1 × $0.0200$0.0200
Xiaohongshu product detail5 × $0.0200$0.1000
Xiaohongshu product reviews5 × $0.0200$0.1000
In all, 11 calls$0.2200

Use it in your AI

Connect once and your AI finds these endpoints, checks the price and calls them by itself.

Just say itAny connected AI
Use DataXAPI to search Xiaohongshu's shop for “防晒霜”, then summarise the buyer reviews of the first five products.
Not connected yet?Paste this prompt into your agent
Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.
Sign in to copy it with your key
Ask with this pageSends the Markdown version

Questions about Xiaohongshu Shop data

Short answers. The details are on each endpoint's page.

Xiaohongshu product search API →
How much does it cost?

Per call, no subscription. All 3 endpoints cost $0.0200 a call. You are charged when data comes back; a failed call costs nothing.

How many reviews can I read?

The first page, in the platform's own order: 12 on the product recorded, at most 20. There is no next page. Each review has the text, the rating out of 5, the variant bought, the pictures and, in the full view, its likes.

Does a review say which product it is about?

No. Xiaohongshu's reviews do not name their product, so product_id is not given; keep the product ID you asked with.

Do search results have a rating?

No. A search card carries the title, prices, units sold, one picture and the shop. The rating, the number of reviews and the description come with the product detail.

Do I need a Xiaohongshu Shop or Xiaohongshu account?

No. You hold one DataXAPI key: no Xiaohongshu login, no cookie, no advertiser account.

The same kind of data elsewhere

The same key and the same response shape read these too.

All 21 Xiaohongshu endpoints →

More named data products

Read Xiaohongshu Shop with one key.

No platform login, no cookie, no subscription. A failed call is free.

Start free