A buyer's review of a product: stars, text and the variant bought.
Canonical page: https://okdata.online/docs/objects/review/
The same shape on every platform. A field a platform does not have is null, and meta.unavailable says why. Use fields= to keep only what you need.
| 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. |
translation |
string | null | The review in English, as the store translates it; null where the store gives no translation. |
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. |
- TikTok Shop product reviews (
tiktok.shop.products.reviews.list): $0.002 per call · about 20 reviews per page - Xiaohongshu shop product reviews (
xiaohongshu.shop.products.reviews.list): $0.02 per call · about 12 reviews per page - Amazon product reviews (
amazon.products.reviews.list): $0.006 per call · about 10 reviews per page - AliExpress product reviews (
aliexpress.products.reviews.list): $0.002 per call · about 20 reviews per page - Taobao product reviews (
taobao.products.reviews.list): $0.043 per call · about 20 reviews per page - 1688 product reviews (
alibaba_1688.products.reviews.list): $0.022 per call · about 10 reviews per page - Douyin Shop product reviews (
douyin_shop.products.reviews.list): $0.039 per call · about 20 reviews per page - App Store reviews (
app_store.apps.reviews.list): $0.001 per call · about 50 reviews per page