Xiaohongshu (RED) Product Reviews

API docs
https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/product-reviews

Returns customer reviews for a specified Xiaohongshu e-commerce SKU. Supports pagination, sorting strategy selection, and filtering for reviews with images.

Price
$0.01USD / call
Method
POST
Response
JSON
Parameters
1 required · 4 optional

Playground

Input
Product SKU ID (required), e.g. "669ddd44e05f3700011067ed"
From page, default "score_page"
Page number, start from 0
Show reviews with images only, 0=no, 1=yes
Sort strategy
OutputExample
Responseoutputs · 15.4 KB · 341 lines
[
  {
    "data": {
      "code": 0,
      "data": {
        "expMap": {
          "aiTagPatternHighlight": 0,
          "mallReviewLivePhoto": 1,
          "pingjiabiaoqian": 1,
          "pingjiaerjiyegaiban": 1,
          "review_image_optimization_v2": 1,
          "sharePicShow": 1,
          "subReviewLadder": 1
        },
        "hasMore": true,
        "reviews": [
          {
            "reviewInfo": {
              "commentType": 5,
              "content": "非常貌美,就是甲片是薄的,不是很硬,但是我觉得完全没问题,很闪很好看,嬛嬛甲的回购款,很上镜",
              "createTimeDesc": "2025-09-26",
              "forbiddenReply": false,
              "highlightSubContent": "",
              "images": [
                "https://qimg.xiaohongshu.com/comment/1040g3mg31mt1ebh0lmdg5ohikl041s0qu52sr38",
                "https://qimg.xiaohongshu.com/comment/1040g3mg31mt1ebh0lmd05ohikl041s0q5agof5g",
                "https://qimg.xiaohongshu.com/comment/1040g3mg31mt1ebh0lm9g5ohikl041s0q6u80b4g"
              ],
              "imagesV3": [
                {
                  "height": 3072,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lmdg5ohikl041s0qu52sr38?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lmdg5ohikl041s0qu52sr38?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3072
                },
                {
                  "height": 3072,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lmd05ohikl041s0q5agof5g?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lmd05ohikl041s0q5agof5g?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3072
                },
                {
                  "height": 3548,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lm9g5ohikl041s0q6u80b4g?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lm9g5ohikl041s0q6u80b4g?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 2660
                }
              ],
              "itemScore": 5,
              "likeCount": 3,
              "logisticsScore": 5,
              "newSkuScore": 5,
              "reviewId": "536239058224620345",
              "rootReviewId": "536239058224620345858981",
              "serviceScore": 5,
              "status": 2,
              "subReviewCount": 4,
              "tags": [
                {
                  "display_style": 0,
                  "id": "497373305360860139",
                  "name": "很显手漂亮"
                },
                {
                  "display_style": 0,
                  "id": "497373305994200525",
                  "name": "很闪亮"
                },
                {
                  "display_style": 0,
                  "id": "173150062536266625",
                  "name": "很好看"
                },
                "… 1 more items in the full response"
              ],
              "viewUserLiked": false
            },
            "subReviews": [],
            "tags": [
              {
                "name": "回头客"
              }
            ],
            "translateFlag": false,
            "userInfo": {
              "anonymous": false,
              "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31p8idp8ciu6g5ohikl041s0q4200vvg?imageView2/2/w/80/format/jpg",
              "name": "小Yang",
              "userId": "a6d14cec6202ba027205f5b9286c9",
              "visitorFlag": false
            },
            "variants": [
              {
                "id": "5a60c42f69bd891ed8939bc0",
                "name": "尺寸",
                "value": "s"
              },
              {
                "id": "60404e0de85df80001991224",
                "name": "颜色分类",
                "value": "H01"
              }
            ]
          },
          {
            "reviewInfo": {
              "commentType": 5,
              "content": "辛小七美甲YYDS,要一直保持下去这个质量和价格啊。我已经在这里买了好几次了,每一个都好好看,一个也没有踩雷,和直播间看到的一样。完全没有色差。在其他直播间买回来的色差都巨大而且送的胶也不好用,客服态度也不好。但是辛小七家的又便宜又好用,质量也好。送的果冻胶也很牢固,我一般可以戴八九天左右不掉,之前戴一个有钻的,钻不小心勾头发上了,我把手指扯下来都没有扯掉,而且掉了以后甲片还可以二次利用,甲片质量也很好。再也没有比这家店性价比还高的店了,物美价廉大家快冲❤️❤️❤️❤️",
              "createTimeDesc": "2025-08-07",
              "forbiddenReply": false,
              "highlightSubContent": "",
              "images": [
                "https://qimg.xiaohongshu.com/comment/1040g2u031ks6vjrej25g5pjc6qsgu8fi3d9akeo",
                "https://qimg.xiaohongshu.com/comment/1040g2u031ks6vjrej2505pjc6qsgu8fic0e4r40",
                "https://qimg.xiaohongshu.com/comment/1040g2u031ks6vjrej22g5pjc6qsgu8fih9akprg",
                "… 1 more items in the full response"
              ],
              "imagesV3": [
                {
                  "height": 4096,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g2u031ks6vjrej25g5pjc6qsgu8fi3d9akeo?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g2u031ks6vjrej25g5pjc6qsgu8fi3d9akeo?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3072
                },
                {
                  "height": 3072,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g2u031ks6vjrej2505pjc6qsgu8fic0e4r40?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g2u031ks6vjrej2505pjc6qsgu8fic0e4r40?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 4096
                },
                {
                  "height": 4096,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g2u031ks6vjrej22g5pjc6qsgu8fih9akprg?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g2u031ks6vjrej22g5pjc6qsgu8fih9akprg?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3072
                },
                "… 1 more items in the full response"
              ],
              "itemScore": 5,
              "likeCount": 5,
              "logisticsScore": 5,
              "newSkuScore": 5,
              "reviewId": "517991790415311841",
              "rootReviewId": "517991790415311841902543",
              "serviceScore": 5,
              "status": 2,
              "subReviewCount": 0,
              "viewUserLiked": false
            },
            "subReviews": [],
            "tags": [
              {
                "name": "回头客"
              }
            ],
            "translateFlag": false,
            "userInfo": {
              "anonymous": false,
              "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31l6mpu5cj45g5pjc6qsgu8fia3q5k28?imageView2/2/w/80/format/jpg",
              "name": "Dreaming",
              "userId": "ab3de0c6858862279aefb2e0c6639",
              "visitorFlag": false
            },
            "variants": [
              {
                "id": "5a60c42f69bd891ed8939bc0",
                "name": "尺寸",
                "value": "s"
              },
              {
                "id": "60404e0de85df80001991224",
                "name": "颜色分类",
                "value": "H02"
              }
            ]
          },
          {
            "reviewInfo": {
              "commentType": 5,
              "content": "收到之后很惊喜,不只是价格实惠,而且是我想要的色调,甲型也是我想要的,上手之后尺寸也是很合适,第一次评价这么用心,不光价格实惠,上手很漂亮,值得推荐,看我美美的返图!马上复购一副备用。",
              "createTimeDesc": "2025-09-11",
              "forbiddenReply": false,
              "highlightSubContent": "",
              "images": [
                "https://qimg.xiaohongshu.com/comment/1040g3mg31m9j5lrrks9g5pgibudgu2pre4iif9g",
                "https://qimg.xiaohongshu.com/comment/1040g3mg31m9j5lrrksa05pgibudgu2prfb1pdmo",
                "https://qimg.xiaohongshu.com/comment/1040g3mg31m9j5lrrksag5pgibudgu2prapqthug",
                "… 2 more items in the full response"
              ],
              "imagesV3": [
                {
                  "height": 4032,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31m9j5lrrks9g5pgibudgu2pre4iif9g?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31m9j5lrrks9g5pgibudgu2pre4iif9g?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3024
                },
                {
                  "height": 4032,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31m9j5lrrksa05pgibudgu2prfb1pdmo?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31m9j5lrrksa05pgibudgu2prfb1pdmo?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3024
                },
                {
                  "height": 4032,
                  "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31m9j5lrrksag5pgibudgu2prapqthug?imageView2/2/w/540/format/webp&ap=3&sc=EVA_SHOT",
                  "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31m9j5lrrksag5pgibudgu2prapqthug?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL",
                  "width": 3024
                },
                "… 2 more items in the full response"
              ],
              "itemScore": 5,
              "likeCount": 3,
              "logisticsScore": 5,
              "newSkuScore": 5,
              "reviewId": "530768092599366058",
              "rootReviewId": "530768092599366058701113",
              "serviceScore": 5,
              "status": 2,
              "subReviewCount": 0,
              "tags": [
                {
                  "display_style": 0,
                  "id": "368862726308884720",
                  "name": "尺寸合适"
                },
                {
                  "display_style": 0,
                  "id": "497370851852402785",
                  "name": "很惊艳"
                },
                {
                  "display_style": 0,
                  "id": "480410072693123051",
                  "name": "很漂亮"
                },
                "… 2 more items in the full response"
              ],
              "viewUserLiked": false
            },
            "subReviews": [],
            "translateFlag": false,
            "userInfo": {
              "anonymous": false,
              "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/661616a118874b056e2599b0.jpg?imageView2/2/w/80/format/jpg",
              "name": "恋尚珠宝水晶",
              "userId": "a2707d9a67cb3b3daebe6d095b2ac",
              "visitorFlag": false
            },
            "variants": [
              {
                "id": "5a60c42f69bd891ed8939bc0",
                "name": "尺寸",
                "value": "s"
              },
              {
                "id": "60404e0de85df80001991224",
                "name": "颜色分类",
                "value": "H02"
              }
            ]
          },
          "… 9 more items in the full response"
        ],
        "sortedPicResult": {
          "hasMore": false,
          "sortedPicsInfos": [
            {
              "enableDelete": false,
              "imageContents": {
                "content": "实在美丽[色色R]",
                "createTime": "02-03",
                "desc": "发布于笔记评论区",
                "fileId": "comment/1040g4b831s3uoeqblm805pevt92h97d5dmjmmng",
                "height": 480,
                "mainItemId": "669ddd44e05f3700011067d4",
                "order": 1,
                "thumbnailUrl": "https://sns-na-i11.xhscdn.com/comment/1040g4b831s3uoeqblm805pevt92h97d5dmjmmng?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=22&sc=LF_PRV&sign=b0b25f19a6805e545697d4c5ae9f6943&t=6a86cb96",
                "url": "https://sns-na-i11.xhscdn.com/comment/1040g4b831s3uoeqblm805pevt92h97d5dmjmmng?imageView2/2/w/1440/format/webp&ap=22&sc=LF_DTL&sign=b0b25f19a6805e545697d4c5ae9f6943&t=6a86cb96",
                "width": 360
              },
              "userInfo": {
                "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31ml9nf58mg0g5pevt92h97d5gilvkdo?imageView2/2/w/80/format/jpg",
                "name": "屁桃不喝旺仔🐟",
                "userId": "a243932d824dee17ae3d4aece6370",
                "visitorFlag": false
              }
            },
            {
              "enableDelete": false,
              "imageContents": {
                "content": "实在美丽[色色R]",
                "createTime": "02-03",
                "desc": "发布于笔记评论区",
                "fileId": "comment/1040g4b831s3uoeqblm705pevt92h97d5qvg5350",
                "height": 480,
                "mainItemId": "669ddd44e05f3700011067d4",
                "order": 4,
                "thumbnailUrl": "https://sns-na-i11.xhscdn.com/comment/1040g4b831s3uoeqblm705pevt92h97d5qvg5350?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=22&sc=LF_PRV&sign=1e98f96981f3df7f4818970dfdeb691f&t=6a86cb96",
                "url": "https://sns-na-i11.xhscdn.com/comment/1040g4b831s3uoeqblm705pevt92h97d5qvg5350?imageView2/2/w/1440/format/webp&ap=22&sc=LF_DTL&sign=1e98f96981f3df7f4818970dfdeb691f&t=6a86cb96",
                "width": 360

Examples

Select an example to load its inputs and result into the playground.

API README

Xiaohongshu (RED) Product Reviews API

Returns customer reviews for one Xiaohongshu (RED) shop SKU. Each review has the text, score, photos, buyer name and the purchased variant. You pass the product sku_id.

Use cases

  • Read buyer feedback on a single SKU to spot recurring complaints about size, color or quality.
  • Collect review photos for a SKU to see how the product looks in real use.
  • Compare which variants, such as color or size, buyers choose most often.
  • Track repeat buyers through the purchase-count tags on each review.

Request

curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/product-reviews" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku_id": "669ddd44e05f3700011067ed"}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
sku_idstringYesProduct SKU ID (required), e.g. "669ddd44e05f3700011067ed"
from_pagestringNoFrom page, default "score_page"
pageintegerNoPage number, start from 0
share_pics_onlyintegerNoShow reviews with images only, 0=no, 1=yes
sort_strategy_typeintegerNoSort strategy

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "code": 0,
  "data": {
    "expMap": {
      "aiTagPatternHighlight": 0,
      "mallReviewLivePhoto": 1,
      "pingjiabiaoqian": 1,
      "pingjiaerjiyegaiban": 1,
      "review_buyer_identity_style": 1,
      "review_image_optimization_v2": 1,
      "sharePicShow": 1,
      "subReviewLadder": 1
    },
    "hasMore": true,
    "reviews": [
      {
        "reviewInfo": {
          "commentType": 5,
          "content": "非常貌美,就是甲片是薄的,不是很硬,但是我觉得完全没问题,很闪很好看,嬛嬛甲的回购款,很上镜",
          "createTimeDesc": "2025-09-26",
          "forbiddenReply": false,
          "highlightSubContent": "",
          "images": [
            "https://qimg.xiaohongshu.com/comment/1040g3mg31mt1ebh0lmdg5ohikl041s0qu52sr38"
          ],
          "imagesV3": [
            {
              "height": 3072,
              "thumbnailUrl": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lmdg5ohikl041s0qu52sr38?ima…",
              "url": "https://mall-i10.xhscdn.com/comment/1040g3mg31mt1ebh0lmdg5ohikl041s0qu52sr38?ima…",
              "width": 3072
            }
          ],
          "itemScore": 5
        },
        "subReviews": [],
        "tags": [
          {
            "name": "本店购买3次"
          }
        ],
        "translateFlag": false,
        "userInfo": {
          "anonymous": false,
          "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31p8idp8ciu6g5ohikl041s0q4200vvg…",
          "name": "小Yang",
          "userId": "a7413e5b9ac9d918d1bb6401e7e3c",
          "visitorFlag": false
        },
        "variants": [
          {
            "id": "5a60c42f69bd891ed8939bc0",
            "name": "尺寸",
            "value": "s"
          }
        ]
      }
    ],
    "sortedPicResult": {
      "hasMore": false,
      "sortedPicsInfos": [
        {
          "enableDelete": false,
          "imageContents": {
            "content": "实在美丽[色色R]",
            "createTime": "02-03",
            "desc": "发布于笔记评论区",
            "fileId": "comment/1040g4b831s3uoeqblm805pevt92h97d5dmjmmng",
            "height": 480,
            "mainItemId": "669ddd44e05f3700011067d4",
            "order": 1,
            "thumbnailUrl": "https://sns-na-i11.xhscdn.com/comment/1040g4b831s3uoeqblm805pevt92h97d5dmjmmng?i…"
          },
          "userInfo": {
            "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31ml9nf58mg0g5pevt92h97d5gilvkdo…",
            "name": "屁桃不喝旺仔🐟",
            "userId": "a4a500e71062633550b74e90e2509",
            "visitorFlag": false
          }
        }
      ],
      "totalSortedPicNums": 4
    }
  },
  "debug_id": "f99f0822",
  "debug_info": "gAAAAABq6ZFqq2GT8Vt6c6kEFerbqCq4pL7f442QB72UwPx1KanH6v9yhTqciK8uFSVslDhJjPaVI752…",
  "msg": "ok",
  "success": true
}

Response fields

FieldMeaning
data.reviews[].reviewInfo.contentReview text written by the buyer.
data.reviews[].reviewInfo.itemScoreStar score the buyer gave the item. The example reviews show 5.
data.reviews[].reviewInfo.createTimeDescReview date as a YYYY-MM-DD string.
data.reviews[].reviewInfo.images / data.reviews[].reviewInfo.imagesV3[].urlPhoto links attached to the review. imagesV3 also gives width, height and thumbnailUrl for each photo.
data.reviews[].variants[].name / data.reviews[].variants[].valueThe variant the buyer purchased, such as size (尺寸) or color (颜色分类) with its chosen value.
data.reviews[].tags[].nameLabel on the review, for example how many times the buyer purchased from this shop. Not every review has tags.
data.reviews[].userInfo.name / data.reviews[].userInfo.userIdDisplay name and ID of the reviewer.
data.reviews[].subReviewsList of follow-up reviews. It is empty in the example.
data.hasMoretrue when more reviews exist beyond the current page.
data.sortedPicResult.sortedPicsInfos[]Photos shared in note comments for this product. Each entry has the image imageContents and the poster's userInfo. totalSortedPicNums gives the count.

Notes

  • Pages start at 0. Raise page while data.hasMore is true to read further reviews.
  • Set share_pics_only to 1 to return only reviews with images.
  • Use sort_strategy_type to change the sort order. The accepted values are not listed in the schema.
  • To find a sku_id, use Xiaohongshu (RED) Product Search. For a summary of ratings, see Xiaohongshu (RED) Product Review Overview.

Pricing

$0.01 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON

Questions

FAQ

How do I use the Xiaohongshu (RED) Product Reviews API?

Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/product-reviews with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Xiaohongshu (RED) Product Reviews API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Xiaohongshu (RED) Product Reviews API accept?

Required: sku_id (string). Optional: from_page (string), page (integer), share_pics_only (integer) and sort_strategy_type (integer). The Parameters table and the Playground on this page list every field.

What does the Xiaohongshu (RED) Product Reviews API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Xiaohongshu developer account or API key?

No. Xiaohongshu (RED) Product Reviews runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Xiaohongshu API access separately.