tiktok/shop-web/product-reviews-v2

Get product reviews V2

Purpose:

• Get TikTok Shop product reviews
• Support multiple filtering and sorting options
• More complete data structure with detailed review information 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
• sort_rule: Sort rule, default 2
• 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 (20 per page)
            {
                "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
                "product_info": {},       // Product info
                "likes_count": 10,        // Likes count
                "seller_reply": {}        // Seller reply
            }
        ],
        "has_more": 1,                    // Has more: 1=yes, 0=no
        "page_start": 1,                  // Current page
        "total_count": 500,               // Total review count
        "review_summary": {               // Review summary
            "average_rating": 4.8,
            "star_distribution": {        // Star distribution
                "5": 400,
                "4": 80,
                "3": 15,
                "2": 3,
                "1": 2
            }
        }
    }
}

[Example]

product_id = "1729408816995078528" page_start = 1 sort_rule = 2 filter_type = 1 filter_value = 6 region = "US"

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