Review object

2 endpoints on 2 platforms return the Review object with the same 10 fields, so code written for one platform reads the others unchanged. A call costs $0.0020 to $0.0200. It is a preview structure and may still change.

Preview object · Updated 2026-10-17Open in ChatGPTOpen in Claude

A Review is what a buyer wrote about a product and the rating they gave it, out of 5, with the variant bought and any pictures attached. A review with a rating and no words has text set to null.

It hangs under a product, not a post: on TikTok Shop product_id names the product, while Xiaohongshu's reviews do not name theirs, so keep the ID you asked with. It is not a Comment: a comment is under a post and carries no rating.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

ID

product_id text

ID of the product it reviews

text text

Text of the review; null when the buyer gave a rating and wrote nothing

rating number

The buyer's rating of the product, out of 5

published_at time

When it was written

author object

Reviewer

author.id text

Reviewer's account ID

author.name text

Reviewer's display name, as the platform shows it (it may be masked)

author.avatar_url link standard

Reviewer's avatar

images list of link standard

Addresses of the pictures the buyer attached

variant text standard

Which variant was bought, as the platform words it

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on
product_idXiaohongshu (RedNote)
published_atXiaohongshu (RedNote)
One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Review

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
TikTok Shop product reviewsGET/v1/tiktok/shop/products/reviews/list$0.0020
Xiaohongshu product reviewsGET/v1/xiaohongshu/shop/products/reviews/list$0.0200

Example

One item from tiktok.shop.products.reviews.list, as recorded 2026-10-12 21:49 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Review · tiktok.shop.products.reviews.list
{
  "id": "7241346721132232026",
  "product_id": "1711666895973198690",
  "text": "Better quality than I expected, well packed.",
  "rating": 5,
  "published_at": "2025-11-08T18:07:48.019Z",
  "author": {
    "id": "6532506578034157649",
    "name": "Hannah Weiss",
    "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/2d964118424ccf033c18~c5_100x100.jpeg"
  },
  "images": [
    "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/3cca00c14d044f99de43~c5_720x720.jpeg"
  ],
  "variant": "Colour: Forest green"
}

The whole response is on the endpoint's page →

Related

Other objects