↑ ↓ to move ↵ to open
TikTok API reference

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
POST /execute
Run an endpoint
MCP tool when pinned
tiktok__shop__reviews
Pin tools
OpenAPI
openapi.json
Download

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"  }}'

Input

FieldTypeRequiredWhat it doesExample
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:

results[0].data
{  "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

FieldTypeWhat it isExample
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

Something missing or unclear? Ask the team that builds the TikTok endpoints.