tiktok/shop-web/product-reviews

Get product reviews V1

Purpose:

• Get TikTok Shop product reviews
• Support custom page size, multiple filtering and sorting options Parameters:
• product_id: Product ID (required)
• page_start: Starting page number, default 1
  • When has_more=1 in response, use current page +1 for next page
• page_size: Reviews per page, default 10
• sort_rule: Sort rule, default 1
• filter_type: Filter type
  • 1: Default, no filter
  • 2: Contains images or videos
  • 3: Verified purchase filter
• filter_value: Star filter
  • 6: All star ratings (default)
  • 5: 5-star reviews
  • 4: 4-star reviews
  • 3: 3-star reviews
  • 2: 2-star reviews
  • 1: 1-star reviews
• region: Region code, available regions are as follows:
  • US: United States
  • GB: United Kingdom
  • SG: Singapore
  • MY: Malaysia
  • PH: Philippines
  • TH: Thailand
  • VN: Vietnam
  • ID: Indonesia Important Notice:
• Due to API rate limiting, please set request timeout to 30 seconds
• If you encounter error code 400, please retry the request 3 times
• Only products accessible via TikTok Shop Web are supported Response Structure:

{
    "code": 0,
    "message": "success",
    "data": {
        "reviews": [                      // Review list
            {
                "review_id": "xxx",
                "user": {                 // User info
                    "user_id": "xxx",
                    "nickname": "Username",
                    "avatar": "Avatar URL"
                },
                "rating": 5,              // Rating (1-5 stars)
                "content": "Review content",
                "medias": [               // Media files (images/videos)
                    {
                        "type": "image",
                        "url": "Media URL"
                    }
                ],
                "create_time": 0,         // Create timestamp
                "verified_purchase": true, // Is verified purchase
                "likes_count": 10,        // Likes count
                "seller_reply": {}        // Seller reply
            }
        ],
        "has_more": 1,                    // Has more: 1=yes, 0=no
        "page_start": 1,                  // Current page
        "page_size": 10,                  // Page size
        "total_count": 500                // Total review count
    }
}

[Example]

product_id = "1729508370969629931" page_start = 1 page_size = 10 sort_rule = 1 filter_type = 1 filter_value = 6 region = "US"

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.