Social Fetch
TikTok

List TikTok Shop product reviews

Get buyer reviews for a TikTok Shop product.

GET/v1/tiktok/products/reviews
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
4
urlstringquery

Public TikTok Shop product detail page URL for the product whose reviews should be listed.

min 1 chars · max 4096 chars

productIdstringquery

TikTok Shop product identifier. Provide this instead of `url` when you already know the product id.

min 1 chars

regionstringquery

Optional country or region code for the product review catalog. When omitted, the default catalog region applies.

one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE

pageintegerquery

1-based review page number. Omit to request the first page.

≥ 1

Response fields
38

Endpoint-specific response payload.

datalookupStatus
string

Whether the product could be resolved for this request.

one of: found, not_found

Customer reviews for the product on this page.

datareviews[]id
string

Stable id for the review when available.

min 1 chars

datareviews[]productId
string

TikTok Shop product id for this review.

min 1 chars

datareviews[]skuId
stringnullable

Sku id for the purchased variant, when available.

min 1 chars

datareviews[]rating
integer

Star rating for the review (1-5).

≥ 1 · ≤ 5

datareviews[]text
stringnullable

Review body text, when available.

datareviews[]createdAt
stringnullable

ISO-8601 timestamp for when the review was posted, when available.

min 1 chars

datareviews[]verifiedPurchase
booleannullable

Whether the review is from a verified purchase, when available.

datareviews[]incentivized
booleannullable

Whether the review is marked as incentivized, when available.

Reviewer display information.

datareviews[]reviewerid
stringnullable

Reviewer id when available.

min 1 chars

datareviews[]reviewername
stringnullable

Display name when available.

min 1 chars

datareviews[]revieweravatarUrl
stringnullable

Profile image URL when available.

min 1 chars

Media attached to a review.

datareviews[]mediadisplayImageUrl
stringnullable

Primary image attached to the review, when available.

min 1 chars

Additional image URLs for the review when available.

datareviews[]mediaimageUrls[]
stringoptional

min 1 chars

datareviews[]variant
stringnullable

Human-readable label for the purchased variant, when available.

min 1 chars

datareviews[]country
stringnullable

Country code associated with the review, when available.

min 1 chars

Summary statistics for the product review set.

datasummarytotalReviews
integernullable

Total number of reviews reported for the product, when available.

≥ 0

datasummaryaverageRating
numbernullable

Average star rating, when available.

≥ 0

Breakdown of reviews by star rating, when available.

datasummaryratingDistributiononeStar
integernullable

Count of 1-star ratings, when available.

≥ 0

datasummaryratingDistributiontwoStar
integernullable

Count of 2-star ratings, when available.

≥ 0

datasummaryratingDistributionthreeStar
integernullable

Count of 3-star ratings, when available.

≥ 0

datasummaryratingDistributionfourStar
integernullable

Count of 4-star ratings, when available.

≥ 0

datasummaryratingDistributionfiveStar
integernullable

Count of 5-star ratings, when available.

≥ 0

Pagination information for the current response.

datapagecurrentPage
integer

1-based page number for this response.

≥ 1

datapagenextPage
integernullable

Next page number to request when more pages are available; otherwise null.

≥ 1

datapagehasMore
boolean

Whether another page of reviews is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/tiktok/products/reviews?url=https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Product reviews for the requested page. `lookupStatus` is `not_found` when the product cannot be resolved.

On this page

No Headings