TikTok Shop Fetch Product Reviews V2

2.07 credits/call
ae_tiktok_shop_fetch_product_reviews_v2

Fetch reviews for a product. Provide the required product_id. Optional parameters are page_start (page number, default 1), sort_rule (1 for recommended or 2 for most recent, default 2), filter_type (1 for all reviews, 2 for reviews with images or videos, or 3 for verified-purchase reviews; default 1), filter_value, and region (default US; supported codes are US, SG, MY, PH, TH, VN, ID, JP, and MX; GB and BR are unavailable). When filter_type is 1, set filter_value to 6 for all ratings or 1–5 for a specific star rating. When filter_type is 2 or 3, use filter_value 1. The review list is at data.data.product_reviews and may be empty. Check the boolean data.data.has_more; if true, increment page_start while keeping the other filter and sort values unchanged. total_reviews and review_ratings.review_count are strings; rating values are numeric. Review entries can include review_rating, review_time, review_text, review_images, and is_verified_purchase; optional fields vary by response. A page_start field is not guaranteed in the response.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
regionstringNo地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable.US
sort_ruleintegerNo排序规则/Sort order: 1=推荐/Recommended, 2=最近/Most recent2
page_startintegerNo起始页码/Page start1
product_idstringYes商品ID/Product ID—
filter_typeintegerNo筛选类型/Filter type: 1=全部/All, 2=含图片或视频/With images or videos, 3=真实购买/Verified purchase1
filter_valueintegerNo筛选值/Filter value: filter_type=1 时 6=全部、5-1=对应星级;filter_type=2 或 3 时固定传1 / For filter_type=1, 6=all and 5-1=star rating; use 1 for filter_type=2 or 36

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_fetch_product_reviews_v2' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "product_id": "1729543855807566564",
    "region": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "detail": {
    "code": 400,
    "message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
    "message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
    "request_id": "f518b798-8b69-4565-a73c-ad4a71973aa7"
  }
}

This example shows part of the response. Copied content is valid JSON.