Xiaohongshu (RedNote)xiaohongshu.shop.products.reviews.list

Xiaohongshu shop product reviews API

The first page of buyers' reviews of a product in Xiaohongshu's shop: stars, text, the variant bought, photos and likes. The app gives no further page.

GEThttps://api.okdata.online/v1/xiaohongshu/shop/products/reviews/list

Price

One call costs $0.02 and returns one page of about 12 reviews. Collecting 1,000 reviews takes about 84 calls, $1.68 in total. Each page is a separate call; failed calls are not charged.

Parameters

Name	Type	Description
`id` *required	string	The product ID (24 hex characters), from the shop product search. e.g. `6441fb9a6cd6140001acf7b4`
`sort`	stringrelevancelatest	Result order. default `relevance`
`cursor`	string	Opaque cursor from page.next_cursor of the previous call. Each page is a separate call.
`view`	stringcompactstandardfull	How much of each object comes back. full adds platform-specific fields under ext. default `standard`
`fields`	string	Comma-separated fields to keep, to save tokens.

cursor, view and fields work the same on every endpoint: how requests work.

Returned fields

Each item is a Review.

Field	Type	Description
`id`	string	Review ID.
`product_id`	string	ID of the product reviewed.
`rating`	number \| null	Stars, 1 to 5.
`text`	string	Review text; empty when the buyer left only stars.
`published_at`	string \| null	When it was posted, ISO 8601 in UTC (a day for platforms that show only the date).
`author_name`	string \| null	Reviewer name as the shop shows it, often masked.
`variant`	string \| null	The variant bought.
`images`	string[] \| null	Photos attached to the review.
`likes`	integer \| null	Likes on the review.
`verified_purchase`	boolean \| null	Whether the shop marks it as a verified purchase.

Request

cURL

curl -G "https://api.okdata.online/v1/xiaohongshu/shop/products/reviews/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=6441fb9a6cd6140001acf7b4'

Python

import os
import requests

resp = requests.get(
    "https://api.okdata.online/v1/xiaohongshu/shop/products/reviews/list",
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    params={"id": "6441fb9a6cd6140001acf7b4"},
    timeout=60,
)
body = resp.json()
if body["code"] != "ok":
    raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")

for row in body["data"]["items"]:
    print(row["rating"], row["text"][:80])
print("cost: $" + body["meta"]["billing"]["amount"])

TypeScript

const url = new URL('https://api.okdata.online/v1/xiaohongshu/shop/products/reviews/list');
url.searchParams.set('id', "6441fb9a6cd6140001acf7b4");

const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${process.env.OKDATA_API_KEY}`,
  },
});
const body = await res.json();
if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`);

for (const row of body.data.items) {
  console.log(row.rating, row.text.slice(0, 80));
}
console.log('cost: $' + body.meta.billing.amount);

MCPtools/call

{
  "name": "call",
  "arguments": {
    "endpoint": "xiaohongshu.shop.products.reviews.list",
    "params": {
      "id": "6441fb9a6cd6140001acf7b4"
    }
  }
}

Or ask an agent that has the MCP server connectedUse Xiaohongshu shop product reviews, read the first two pages and sum up what buyers like and what they complain about.

Response

200 · application/jsonmeta.billing.amount = 0.02

{
  "code": "ok",
  "request_id": "0f6c2a8e-4b1d-4e0a-9a51-3c7d2b9e1f20",
  "data": {
    "items": [
      {
        "id": "424335956727206176",
        "product_id": "6441fb9a6cd6140001acf7b4",
        "rating": 5,
        "text": "做工扎实，研磨均匀，出门露营带着很方便。",
        "published_at": "2024-11-21T00:00:00Z",
        "author_name": "甜**",
        "variant": "颜色分类：棕橘色",
        "images": [
          "https://cdn.example.com/review/1.jpg"
        ],
        "likes": 42,
        "verified_purchase": null
      }
    ]
  },
  "page": {
    "next_cursor": "eyJvIjoyMH0",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.shop.products.reviews.list",
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    },
    "unavailable": {},
    "cached": false,
    "replayed": false,
    "fetched_at": "2026-11-11T08:00:00Z"
  }
}

Try it

This sends a real call to https://api.okdata.online and is billed as usual: at most $0.02. Failed calls are free. Your key goes only to that address and is never stored on this site.

Questions

How much does the Xiaohongshu shop product reviews API cost?

One call costs $0.02 and returns one page of about 12 reviews. Collecting 1,000 reviews takes about 84 calls, $1.68 in total. Each page is a separate call; failed calls are not charged.

How do I get the next page?

Pass page.next_cursor from the response back as the cursor parameter. When page.has_more is false there is nothing left. Every page is its own call at $0.02.

Do I need a Xiaohongshu (RedNote) account, cookies or a QR login?

No. You send only your okdata API key. The data is public data from Xiaohongshu (RedNote); nothing is fetched with your own Xiaohongshu (RedNote) account.

Am I charged when a call fails?

No. Every error response says charged: false, except a timeout, which says charged: null until the outcome is known. Resend with the same Idempotency-Key and you are never charged twice.

What if Xiaohongshu (RedNote) does not show a field?

The field is null, and meta.unavailable names it with the reason: platform (the platform never shows it) or capability (we cannot fetch it yet).

Answers that use this endpoint

All Xiaohongshu (RedNote) endpoints → · Answers