POST Lấy đánh giá sản phẩm
Lấy đánh giá sản phẩm Shop Scope yêu cầu: Xuất hàng loạt các đánh giá sản phẩm và đơn hàng công khai trên TikTok Shop (theo product ID hoặc order ID) để ISV và người bán tích hợp vào các hệ thống bên ngoài; không bao gồm PII và các đánh giá đã bị ẩn/xóa. Phiên bản 202605
POST/review_rating/202605/product_reviews/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| page_size | int | Số lượng đánh giá trả về trên mỗi trang. Min: 1, Max: 100. Mặc định là 50. |
| page_token | string | Token dùng cho phân trang, được sử dụng để lấy trang kết quả tiếp theo. Lấy từ trường next_page_token của response trước đó. |
| sort_field | string | Trường để sắp xếp kết quả. Mặc định là create_time.Các giá trị có thể có:create_timeupdate_time |
| sort_order | string | Thứ tự sắp xếp kết quả theo create_time. Các giá trị được hỗ trợ: ASC (tăng dần) hoặc DESC (giảm dần). Mặc định là DESC. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| tiktok_product_ids | []string | Một mảng các TikTok product ID để lấy đánh giá. Bắt buộc nếu không cung cấp order_ids hoặc các định danh sản phẩm khác. Tối đa 50 ID mỗi yêu cầu. |
| external_product_ids | []string | Một mảng các định danh sản phẩm hoặc SKU bên ngoài được sử dụng trong một nền tảng thương mại điện tử bên ngoài. Một định danh bên ngoài được dùng trong nền tảng thương mại điện tử bên ngoài. Định danh này được dùng để liên kết sản phẩm giữa TikTok Shop và nền tảng thương mại điện tử bên ngoài. Bắt buộc nếu không cung cấp order_ids hoặc các định danh sản phẩm khác. Tối đa 50 ID mỗi yêu cầu. |
| seller_skus | []string | Một mảng các định danh duy nhất mà người bán sử dụng để theo dõi và quản lý kho hàng của họ. Seller SKU được định nghĩa bởi người bán. Một mã/tên nội bộ để quản lý SKU, không hiển thị với người mua. |
| product_identifier_codes | []string | Một mảng các mã định danh được quản lý quốc tế, bao gồm GTIN, EAN, UPC, hoặc ISBN.Bắt buộc nếu không cung cấp order_ids hoặc các định danh sản phẩm khác. Tối đa 50 ID mỗi yêu cầu. |
| order_ids | []string | Một mảng các order ID để lấy đánh giá. Bắt buộc nếu không cung cấp các định danh sản phẩm. Tối đa 50 ID mỗi yêu cầu. |
| review_start_time | string | Ngày bắt đầu để lọc đánh giá. Định dạng: YYYY-MM-DDTHH:MM:SSZ. GMT (UTC+00:00). "2026-03-25T10:45:00Z" |
| review_end_time | string | Ngày kết thúc để lọc đánh giá. Định dạng: 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 | Mã trạng thái thành công hoặc thất bại được trả về trong response của API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response của API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
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 |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext