Object

Review object

A buyer's review of a product: stars, text and the variant bought. The same fields on every platform. A field a platform does not show is null, and meta.unavailable names it with the reason.

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.

Example · tiktok

{
  "id": "7667220239340095245",
  "product_id": "1732296652516463425",
  "rating": 5,
  "text": "Charges on the USB in my car. Excellent for coffee on the go.",
  "published_at": "2026-07-27T14:10:24Z",
  "author_name": "T** M**h",
  "variant": "Default",
  "images": [
    "https://cdn.example.com/review/1.jpg"
  ],
  "likes": 42,
  "verified_purchase": true
}

Endpoints that return a Review