Social Fetch
TikTok

List TikTok profile showcase products

Get products featured on a creator's TikTok showcase.

Call `GET /v1/tiktok/profiles/{handle}` when you need explicit profile lookup status before interpreting an empty showcase list.

An empty `data.products` array can mean no showcased products, a private profile, or other cases—there is no `lookupStatus` field on this route.

GET/v1/tiktok/profiles/{handle}/showcase-products
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
handle*stringpath

TikTok handle whose profile showcase products should be listed.

min 1 chars · max 128 chars

cursorstringoptionalquery

Pagination cursor returned by a previous response.

min 1 chars

regionstringoptionalquery

Optional region (country code) for the request.

min 1 chars

Response fields
32

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.

dataproducts[]id
string

Product identifier.

min 1 chars

dataproducts[]title
stringnullable

Product title shown on TikTok Shop.

dataproducts[]url
stringnullable

Canonical TikTok Shop URL for the product.

Primary image metadata.

dataproducts[]imageurl
stringnullable

Primary image URL for the product.

Image URLs for the product in preference order.

dataproducts[]imageurls[]
stringoptional
dataproducts[]imagewidth
integernullable

Image width in pixels when available.

≥ 0

dataproducts[]imageheight
integernullable

Image height in pixels when available.

≥ 0

Price details when TikTok provides them.

dataproducts[]pricecurrencyCode
stringnullable

Currency code for displayed prices.

dataproducts[]pricecurrencySymbol
stringnullable

Currency symbol for displayed prices.

dataproducts[]pricesalePrice
stringnullable

Current sale price as a decimal string.

dataproducts[]priceoriginalPrice
stringnullable

Original price before discounts as a decimal string.

dataproducts[]pricediscountPercent
stringnullable

Discount amount as shown by TikTok (often a percentage string).

Rating summary when TikTok provides it.

dataproducts[]ratingscore
numbernullable

Average rating score when TikTok reports one.

dataproducts[]ratingreviewCount
integer

Review count reported by TikTok.

≥ 0

Sales counts reported by TikTok.

dataproducts[]salessoldCount
integer

Sold units reported by TikTok.

≥ 0

Seller metadata when TikTok provides it.

dataproducts[]sellerid
string

Seller identifier.

min 1 chars

dataproducts[]details
objectoptional

Additional TikTok-native fields for this product that were not mapped into canonical fields.

Pagination state for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more products are available.

datapagehasMore
boolean

Whether another page of products 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/profiles/mrtiktokreviews/showcase-products" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Showcase products for the requested TikTok profile.

On this page

No Headings