TIKTOK SHOP API
Product Reviews
Retrieve product reviews from TikTok Shop with a single API request.
GET
/api/data/v1/tiktok/shop/product/reviews1credit base cost
Request parameters
Up to 1 creditThe URL of the product (required if product_id is not provided)
The ID of the product (required if url is not provided)
The region of the product. US is the reliable region right now; non-US regions should not be considered reliable and may return limited or inconsistent review data. Sorry for the inconvenience.
The page number of the reviews
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/tiktok/shop/product/reviews?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fcat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats%2F1731578642912612516' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"has_more": true,
"total_reviews": "5967",
"product_reviews": [
{
"review_id": "7449648277383333678",
"product_id": "1729412793274503379",
"sku_id": "1729480195115684051",
"reviewer_id": "7118466497416561707",
"review_rating": 4,
"review_time": "1734506431877",
"is_verified_purchase": true,
"is_incentivized_review": false,
"product_name": "OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort",
"reviewer_name": "W**n",
"reviewer_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8a5ef54ee47fd27614d4d576879cd630~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=6e5d3b6e&x-expires=1771009200&x-signature=1HE0d6u3ZL2NY%2FWG88r8zUltKS4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5",
"review_text": "Product arrived intact no issues. Love all the attachments. Cuts very very well. Charges quick and efficiently. The only reason I gave a 4 was listening to the reels it’s supposed to be nip free. That was a lie, I nipped my balls and that’s not fun. I took pics other than that great product.",
"display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9460bee85df472a8455f33df693cb8d~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"review_images": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9460bee85df472a8455f33df693cb8d~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
],
"sku_specification": "Black",
"review_country": "US"
}
],
"review_ratings": {
"review_count": "5967",
"overall_score": 4.4,
"rating_result": {
"1": "475",
"2": "161",
"3": "289",
"4": "740",
"5": "4302"
}
},
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"has_more": {
"type": "boolean"
},
"total_reviews": {
"type": "string"
},
"product_reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"review_id": {
"type": "string"
},
"product_id": {
"type": "string"
},
"sku_id": {
"type": "string"
},
"reviewer_id": {
"type": "string"
},
"review_rating": {
"type": "integer"
},
"review_time": {
"type": "string"
},
"is_verified_purchase": {
"type": "boolean"
},
"is_incentivized_review": {
"type": "boolean"
},
"product_name": {
"type": "string"
},
"reviewer_name": {
"type": "string"
},
"reviewer_avatar_url": {
"type": "string"
},
"review_text": {
"type": "string"
},
"display_image_url": {
"type": "string"
},
"review_images": {
"type": "array",
"items": {
"type": "string"
}
},
"sku_specification": {
"type": "string"
},
"review_country": {
"type": "string"
}
}
}
},
"review_ratings": {
"type": "object",
"properties": {
"review_count": {
"type": "string"
},
"overall_score": {
"type": "number"
},
"rating_result": {
"type": "object",
"properties": {
"1": {
"type": "string"
},
"2": {
"type": "string"
},
"3": {
"type": "string"
},
"4": {
"type": "string"
},
"5": {
"type": "string"
}
}
}
}
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}