> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Shop Product Reviews
> Paginated TikTok Shop product reviews with the total and rating breakdown; sort by recommended or recent, filter by star rating, media or verified purchase.
`page`/`count` paginate (up to 50 per page); `sort=recent` for the newest; `rating=1..5`, `with_media=true` or `verified=true` narrow the set — `total` reflects the filter, `rating_breakdown` the whole product. US only.
**Markets** — `region=US` (default) serves everything; `GB` and `ID` (Tokopedia) serve categories, category products and product detail in GBP/IDR. SG, MY, PH, TH, VN, MX, BR and JP sit behind a puzzle our exits do not clear and return `400`.
Each request costs **5 credits**. Failed requests are not charged.
## OpenAPI
````yaml GET /v1/tiktok/shop/products/{product_id}/reviews
openapi: 3.1.0
info:
title: ScrapeBadger TikTok API
version: 1.0.0
description: >-
TikTok scraping API for user profiles, videos, comments, transcripts,
hashtags, music/sounds, search, trending, and the EU Commercial Content (ad
transparency) library. Returns clean structured JSON; handles signing,
anti-bot bypass, and regional proxy routing automatically.
servers:
- url: https://scrapebadger.com
description: Production
security:
- apiKeyAuth: []
paths:
/v1/tiktok/shop/products/{product_id}/reviews:
get:
tags:
- TikTok Shop
summary: Shop Product Reviews
description: >-
Paginated product reviews with the total and rating breakdown. Sort by
`recommended` or `recent`; filter by star `rating`, `with_media`
(photos/videos) or `verified` purchases. US only.
operationId: getTikTokShopProductReviews
parameters:
- name: product_id
in: path
required: true
schema:
type: string
- name: region
in: query
schema:
type: string
default: US
description: Market — US only for this endpoint.
- name: page
in: query
schema:
type: integer
default: 1
minimum: 1
- name: count
in: query
schema:
type: integer
default: 20
minimum: 1
maximum: 50
- name: sort
in: query
schema:
type: string
default: recommended
enum:
- recommended
- recent
- name: rating
in: query
schema:
type: integer
minimum: 1
maximum: 5
description: Only this star rating.
- name: with_media
in: query
schema:
type: boolean
default: false
description: Only reviews with photos/videos.
- name: verified
in: query
schema:
type: boolean
default: false
description: Only verified purchases.
responses:
'200':
description: Shop Product Reviews
content:
application/json:
schema:
$ref: '#/components/schemas/ShopReviewsResponse'
example:
reviews:
- review_id: '7636473773830670093'
rating: 2
text: Es muy bueno, el magnesio para el dolor en el cuerpo
reviewer_name: Ⓜ**3
created_utc: 1778005121
is_verified_purchase: true
is_incentivized: false
sku: Default
images:
- >-
https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/9f460e5abeb840169cce1f0fea3849b0~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast8&from=2378011839
created_at: '2026-05-05T18:18:41Z'
country: US
- review_id: '7631572981256423181'
rating: 5
text: >-
Pwodwi sa vèman bon! Li fasil pou itilize, li bon kalite,
epi li bay bon rezilta. Mwen satisfè 100% epi mwen
rekòmande li bay tout moun . Pa ezite eseye li!”
reviewer_name: S**9
created_utc: 1776864066
is_verified_purchase: true
is_incentivized: false
sku: Default
images:
- >-
https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/992f14ec8dc34793a32c124a71c3be32~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast8&from=2378011839
created_at: '2026-04-22T13:21:06Z'
country: US
total: 6756
rating: 4.5
rating_breakdown:
'1': 9849
'2': 2682
'3': 6537
'4': 13628
'5': 124464
page: 1
has_more: true
product_id: '1729448464509734958'
region: US
'400':
description: Unsupported market or feature for the market
components:
schemas:
ShopReviewsResponse:
properties:
reviews:
items:
$ref: '#/components/schemas/ShopReview'
title: Reviews
type: array
total:
anyOf:
- type: integer
- type: 'null'
default: null
title: Total
rating:
anyOf:
- type: number
- type: 'null'
default: null
title: Rating
rating_breakdown:
additionalProperties:
type: integer
title: Rating Breakdown
type: object
page:
default: 1
title: Page
type: integer
has_more:
default: false
title: Has More
type: boolean
product_id:
title: Product Id
type: string
region:
title: Region
type: string
required:
- product_id
- region
title: ShopReviewsResponse
type: object
ShopReview:
properties:
review_id:
title: Review Id
type: string
rating:
anyOf:
- type: integer
- type: 'null'
default: null
title: Rating
text:
anyOf:
- type: string
- type: 'null'
default: null
title: Text
reviewer_name:
anyOf:
- type: string
- type: 'null'
default: null
title: Reviewer Name
created_utc:
anyOf:
- type: integer
- type: 'null'
default: null
title: Created Utc
is_verified_purchase:
default: false
title: Is Verified Purchase
type: boolean
is_incentivized:
default: false
title: Is Incentivized
type: boolean
sku:
anyOf:
- type: string
- type: 'null'
default: null
title: Sku
images:
items:
type: string
title: Images
type: array
created_at:
anyOf:
- type: string
- type: 'null'
default: null
title: Created At
country:
anyOf:
- type: string
- type: 'null'
default: null
title: Country
required:
- review_id
title: ShopReview
type: object
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````