POST Get product reviews
Get product reviews Shop Required scope: Exports public TikTok Shop product and order reviews in batches (via product or order IDs) for ISVs and sellers to integrate into external systems; excludes PII and hidden/removed reviews. Version 202605
POST/review_rating/202605/product_reviews/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| page_size | int | The number of reviews to return per page. Min: 1, Max: 100. Defaults to 50. |
| page_token | string | A token for pagination, used to retrieve the next page of results. Obtained from the next_page_token field of a previous response. |
| sort_field | string | The field to sort the results by. Defaults to create_time.Possible values:create_timeupdate_time |
| sort_order | string | The order to sort the results by create_time. Supported values: ASC (ascending) or DESC (descending). Defaults to DESC. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| tiktok_product_ids | []string | An array of TikTok product IDs to retrieve reviews for. Required if order_ids or other product identifiers are not provided. Maximum of 50 IDs per request. |
| external_product_ids | []string | An array of external product or SKU identifiers used in an external ecommerce platform. An external identifier used in an external e-commerce platform. This is used to associate the product between TikTok Shop and the external e-commerce platform. Required if order_ids or other product identifiers are not provided. Maximum of 50 IDs per request. |
| seller_skus | []string | An array of unique identifiers that sellers use to track and manage their inventory. Seller SKU is defined by the seller. An internal code/name for managing SKUs, not visible to buyers. |
| product_identifier_codes | []string | An array of internationally regulated identifier codes, including GTIN, EAN, UPC, or ISBN.Required if order_ids or other product identifiers are not provided. Maximum of 50 IDs per request. |
| order_ids | []string | An array of order IDs to retrieve reviews for. Required if product identifiers are not provided. Maximum of 50 IDs per request. |
| review_start_time | string | The start date to filter reviews. Format: YYYY-MM-DDTHH:MM:SSZ. GMT (UTC+00:00). "2026-03-25T10:45:00Z" |
| review_end_time | string | The end date to filter reviews. Format: YYYY-MM-DDTHH:MM:SSZ. GMT (UTC+00:00). "2026-03-25T10:45:00Z" |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 32001006 | Required fields are missing, include them and try again. | | 32002017 | This app is not authorized to use this API. Please contact your partner manager to request access. | | 32002032 | TIKTOK_PRODUCT_ID must be a 16-digit number generated by TikTok Shop. | | 32002033 | EXTERNAL_PRODUCT_ID must be a numeric value with up to 16 digits. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 32002043 | Only one product ID can be used to look up reviews | | 32002044 | Product ID and Order ID cannot be passed at the same time | | 32002045 | Too many orders or product IDs. A single API call can only include up to 50. | | 32002046 | Invalid date format. review_start_time and review_end_time must use ISO 8601 format (e.g 2026-03-25T10:45:00Z) | | 32002047 | review_start_time must be before review_end_time | | 32002048 | Page size should be greater than 0 and no larger than 50 | | 32002049 | Page token is invalid |
Is this content helpful?Helpful
Not Helpful
PreviousNext