Social Fetch
Get API key
TikTok hub

TikTok Profile Showcase Products API

Page the TikTok Shop products a creator features on their profile shelf — by handle, in the same envelope as the rest of the TikTok tag.

GET /v1/tiktok/profiles/{handle}/showcase-products

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Affiliate monitors and creator commerce audits often care about what a handle is selling from their profile, not what a whole storefront lists or what a keyword search returns. You already know the creator; you need the product cards on that account's Shop shelf without opening TikTok for every refresh.

`GET /v1/tiktok/profiles/{handle}/showcase-products` takes a TikTok handle in the path (with or without a leading `@`) and returns product cards under `data.products` plus cursor state under `data.page`. Optional `region` selects a catalog country when the default does not match the shelf you care about. Each product can include id, title, URL, image, price (sale / original / discount text), rating (score, reviewCount), sales (`soldCount`), and seller id. Pagination is cursor-based: when `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` on the next call. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

This route has no `lookupStatus` field. An empty `data.products` array can mean no featured products, a private profile, or other cases — call `GET /v1/tiktok/profiles/{handle}` first when you need an explicit profile outcome before treating an empty shelf as "no commerce." Keyword discovery across Shop is `GET /v1/tiktok/shop/products/search`. A known storefront's full catalog is `GET /v1/tiktok/shop/products`. One PDP by URL is `GET /v1/tiktok/products`. Same Social Fetch API key for all of them.

TikTok Profile Showcase Products API FAQ

What does the TikTok Profile Showcase Products API return?

Product cards under data.products and cursor page state under data.page (nextCursor, hasMore). Each product can include id, title, url, image, price (currencyCode, currencySymbol, salePrice, originalPrice, discountPercent), rating (score, reviewCount), sales (soldCount), seller (id), and optional details. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged. There is no lookupStatus on this route.

How do I list a creator's TikTok profile Shop products via API?

Send GET /v1/tiktok/profiles/{handle}/showcase-products with x-api-key. Put the TikTok username in the path (with or without a leading @). Optionally add region and cursor from a previous page. Full parameter lists and examples are in the API docs.

How much does listing profile showcase products cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

Is a profile showcase shelf the same as a TikTok Shop store catalog?

No. GET /v1/tiktok/profiles/{handle}/showcase-products lists products featured on one creator's profile shelf by handle. GET /v1/tiktok/shop/products lists products for a public storefront when you already have that shop's URL. Keyword discovery across Shop is GET /v1/tiktok/shop/products/search.

How does pagination work on profile showcase products?

Pagination is cursor-based. When data.page.hasMore is true, request the next page with cursor set to data.page.nextCursor. Keep the same handle and region across pages. Omit cursor for the first page.

What does an empty products array mean?

An empty data.products array can mean the creator has no featured products, the account is private, or other cases. This route does not return lookupStatus. Call GET /v1/tiktok/profiles/{handle} when you need found / not_found / private before interpreting an empty shelf.

Can I pick a catalog country for the showcase shelf?

Yes. Pass an optional region query parameter (ISO 3166-1 alpha-2 country code). Omit region when you want the default catalog behavior documented for the route.

Do I need a TikTok Shop seller account to read a creator's shelf?

No. You authenticate to Social Fetch with an API key. The route reads public profile showcase product data; it does not act on behalf of a seller account you manage.

Other TikTok endpoints