TikTok Shop Product Reviews
tiktok.shop.reviews
Read a US TikTok Shop product's public reviews: rating, date, verified purchase and text.
At a glance
- Endpoint ID
tiktok.shop.reviews- Price
- 0.75 credits per call; failed calls are free
- Runs for up to
- 45 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "tiktok.shop.reviews", "input": { "limit": 20, "url": "https://www.tiktok.com/shop/pdp/1729587769570529799" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tiktok.shop.reviews", "input": { "limit": 20, "url": "https://www.tiktok.com/shop/pdp/1729587769570529799" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "tiktok.shop.reviews", "input": { "limit": 20, "url": "https://www.tiktok.com/shop/pdp/1729587769570529799" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
url |
string | yes | Public URL of the page to fetch. | https://www.tiktok.com/shop/pdp/172958776957052… |
limit |
integer | no | Maximum reviews to return from the product page's public review data. From 1 to 100. Default: 20. |
20 |
region |
string | no | Allowed values: US. Default: US. |
US |
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
{ "product_id": "1729587769570529799", "result_count": 5, "reviews": [ { "is_incentivized_review": false, "is_verified_purchase": true, "review_id": "7661003044570531597", "review_rating": 5, "review_text": "Son muy buenas las recomiendo demasiado 👌", "review_time": "1783716291705", "sku_id": "1729587788239049223" }, { "is_incentivized_review": false, "is_verified_purchase": true, "review_id": "7609775675609335565", "review_rating": 1, "review_text": "Estás goli no son iguales alas ke eh comprado estás están feas secas y más pequeñas kisas por eso dieron 6 botes x la compra de tres no me …", "review_time": "1771789010197", "sku_id": "1729587788239049223" } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
reviews[].is_incentivized_review |
boolean | Whether the reviewer was given something for the review. | false |
reviews[].is_verified_purchase |
boolean | Whether TikTok Shop marks it as a verified purchase. | true |
reviews[].review_id |
string | TikTok Shop's ID for the review. | 7661003044570531597 |
reviews[].review_rating |
integer | The star rating the reviewer gave. | 5 |
reviews[].review_text |
string | What the reviewer wrote. | Son muy buenas las recomiendo demasiado 👌 |
reviews[].review_time |
string | When the review was written, as a Unix time in milliseconds. | 1783716291705 |
reviews[].sku_id |
string | The product variant that was reviewed. | 1729587788239049223 |
reviews |
array | The product's reviews. | 5 records |
product_id |
string | TikTok Shop's ID for the product. | 1729587769570529799 |
result_count |
integer | How many reviews this answer holds. | 5 |
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other TikTok endpoints
tiktok.collection.videosCollection videostiktok.comment.repliesComment repliestiktok.feed.trendingTrending feedtiktok.hashtag.postsHashtag videostiktok.live.getLive room detailtiktok.music.infoSong detailtiktok.music.postsSong videostiktok.post.getVideo detailtiktok.profile.getUser profile detailtiktok.search.suggestionsSuggestions searchtiktok.shop.product.getShop product detailtiktok.shop.productsShop store productstiktok.shop.searchShop product searchtiktok.user.followersUser followerstiktok.user.followingUser followingtiktok.user.liveUser live statustiktok.user.videosUser videostiktok.video.commentsVideo commentstiktok.video.transcriptVideo transcript
Something missing or unclear? Ask the team that builds the TikTok endpoints.