TikTok Shop

TikTok Shop Product Reviews

Paginated reviews for a TikTok Shop product — star rating, review text, buyer photos, purchase variant, verified-purchase and incentivized flags, country, and an ISO timestamp — plus the product's star histogram, as JSON. Up to 200 reviews per call for the same 1 credit. Reviewer names arrive pre-masked by TikTok and stay masked; review text is left exactly as the buyer wrote it, including reviews written in other languages. Costs 1 credit per request.

POST/api/v1/tiktok-shop/product/reviews

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

product_idstringrequired

TikTok Shop product id: 6 to 25 digits.

Example: 1732293553906094315

pageintegerdefault:1

1-based page number, 1 to 500. Page past the end and you get an empty reviews array with has_more false, not an error.

Example: 2

page_sizeintegerdefault:20

Reviews per page, 1 to 200. The credit cost is the same at any page size, so a large page is the cheapest way to pull a review corpus.

Example: 200

sortstringdefault:relevant

Ordering. relevant is the default because it returns text-complete, image-heavy reviews; recent is fresher but far more text-sparse, with many rows carrying stars only.

Example: recent

relevant — Text-complete and image-heavy
recent — Newest first; trades text coverage for freshness

ratinginteger

Only reviews with this star rating, 1 to 5. Omit for all ratings.

Example: 5

has_mediabooleandefault:false

Only reviews with a photo or video. Shares one upstream filter slot with verified_only: if both are true, has_media wins and the response's filters_applied reports verified_only false so you are not misled.

Example: true

verified_onlybooleandefault:false

Only verified purchases. See the note on has_media: the two cannot both be applied.

Example: true

regionstringdefault:US

Marketplace region.

Example: US

US — United States
GB — United Kingdom
SG — Singapore
MY — Malaysia
PH — Philippines
TH — Thailand
VN — Vietnam
ID — Indonesia

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok_shop.product_reviews(
    product_id="1732293553906094315",
    page=1,
    page_size=200,
    sort="relevant",
)
print(results)

Response

"product_id": "1732293553906094315",

"page": 1,

"page_size": 20,

"total_reviews": 12561,

"has_more": true

"response_time": 1980,

"credits_used": 1,

"credits_remaining": 4816

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") results = client.tiktok_shop.product_reviews( product_id="1732293553906094315", page=1, page_size=200, sort="relevant", ) print(results)