TikTok Shop

TikTok Shop User Showcase API

Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed discount, and seller name/url.

Pass a TikTok username (with or without @, or a profile URL) and the TikTok Shop User Showcase API returns the products that creator is featuring in their TikTok Shop showcase as clean JSON. This is the affiliate / creator storefront shelf — not the full inventory of a brand store. ttSeller is the merchant-storefront bit (user.ttSeller); affiliate creators are ttSeller:false and still have a shelf — we always fetch it. sellerStatus tells you what an empty list means: no_shop (looked, no merchant shop and no affiliate products), shop_empty (has a shop, zero listed products), has_products (the shelf). An undetermined empty fetch is 502 SHOWCASE_UNAVAILABLE with sellerStatus=unavailable — never a bare products:[] 200. Envelope: source / timings{path,profileMs,showcaseMs,totalMs} / ttSeller. Each product includes id/url/slug, title, price + originalPrice + discountPercent + savingsAmount, currency (only when an amount exists), sold when a per-product figure exists, rating/reviews, image, and seller{id,name,url}. sold is a list-row field here (same rule as Shop Search / Shop Products); Product Details omits it. sold is never the shop's lifetime total stamped onto every tile — if the PDP only exposes shop sold_count, the field is omitted. For a brand's full catalog (where per-product sold is already correct), use TikTok Shop Products with a store URL instead. For stock / skus[] / categories, call Product Details with a product URL. Billed per result when products return; no_shop / shop_empty is 1 credit. Pass cache=true for the 24h shared cache.

Docs: https://captapi.com/apis/tiktok-shop-user-showcase

get/v1/tiktok-shop/user-showcase

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/tiktok-shop/user-showcase
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

usernamestring required

TikTok username, @handle, or profile URL, e.g. jeffreestar or https://www.tiktok.com/@jeffreestar.

limitinteger

Max items to return (default 20, max 200). Billed per result.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.