List TikTok profile showcase products
Lists TikTok Shop products featured on a creator profile showcase with cursor-based pagination. This route does not expose `lookupStatus`; an empty `data.products` array can occur when there are no showcased products, the profile is private, or other cases—call `GET /v1/tiktok/profiles/{handle}` first when you need explicit account status.
Operation
/v1/tiktok/profiles/{handle}/showcase-productsHeaders
API key (`sfk_...`)
Parameters
TikTok handle whose profile showcase products should be listed.
min 1 chars · max 64 chars
Pagination cursor returned by a previous response.
min 1 chars
Optional region (country code) for the request.
min 1 chars
Response fields
Endpoint-specific response payload.
Products shown on the TikTok profile showcase for this page. An empty array can mean no showcased products, a private account, or other cases—call the TikTok profile endpoint first when you need explicit account status.
Product identifier.
min 1 chars
Product title shown on TikTok Shop.
Canonical TikTok Shop URL for the product.
Primary image metadata.
Primary image URL for the product.
Image URLs for the product in preference order.
Image width in pixels when available.
≥ 0
Image height in pixels when available.
≥ 0
Price details when TikTok provides them.
Currency code for displayed prices.
Currency symbol for displayed prices.
Current sale price as a decimal string.
Original price before discounts as a decimal string.
Discount amount as shown by TikTok (often a percentage string).
Rating summary when TikTok provides it.
Average rating score when TikTok reports one.
Review count reported by TikTok.
≥ 0
Sales counts reported by TikTok.
Sold units reported by TikTok.
≥ 0
Seller metadata when TikTok provides it.
Seller identifier.
min 1 chars
Additional TikTok-native fields for this product that were not mapped into canonical fields.
Pagination state for the current response.
Cursor to pass in the next request when more products are available.
Whether another page of products is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Showcase products for the requested TikTok profile.
Error codes
Product reviews
Returns customer reviews for a TikTok Shop product. Pass a public product page `url`, a `productId`, or both. Results are page-based; use `data.page.nextPage` as the `page` query parameter on the next request when `data.page.hasMore` is true. `data.lookupStatus` is `not_found` when the product cannot be resolved.
Profile
Looks up an Instagram profile by handle. Outcomes such as found, private, or not found are indicated in `data.lookupStatus`.