TikTok Shop User Showcase API

TikTok Shop User Showcase

Features

• Single-username showcase collectionCollect public products displayed for one TikTok username, accepting the handle with or without a leading @.
• Market-region selectionChoose one of 16 supported region values so showcase collection targets the intended public TikTok Shop market.
• Bounded unique product resultsRequest 20 through 2,000 showcase products while collection pages are deduplicated by public product identity.
• Normalized product and seller contextReturn product IDs, titles, descriptions, canonical links, images, seller fields, prices, categories, and SKU structures when exposed.
• Visible commerce signals and public boundariesPreserve available ratings, review counts, sold counts, status, region, and collection time while leaving unavailable public fields empty.

Parameters

How to Use

Submit one public username and market as an asynchronous task, then read the saved showcase products with cursor pagination.

1. Prepare one public TikTok username, choose a supported region, and set results_limit from 20 through 2,000.
2. POST the request to /v1/tiktok-shop/user-showcase and save the returned task_id.
3. Poll /v1/tasks/{task_id} until the task reaches succeeded or failed.
4. Read data.results.items. When has_more is true, continue with next_cursor.

curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"mrtiktokreviews","results_limit":100,"region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Best Use Cases

• Review a user's showcase assortment: Use product IDs, titles, links, seller context, images, and categories to inspect the public products displayed for one username.
• Compare price and visible demand signals: Compare available prices, currencies, discounts, ratings, review counts, and sold counts across returned showcase products.
• Create regional showcase snapshots: Store input_username, region, product identity, public commerce fields, and collected_at for repeatable point-in-time review.
• Enrich a product research dataset: Add canonical product URLs, seller identity, media, categories, SKU context, and visible metrics to an existing username-led research set.

Pro Tips

• Use one stable username spelling across runs; the endpoint accepts @handle or handle and records the normalized input username with each product.
• Choose the market that matches the intended catalog because region defaults to US and non-US public availability can vary.
• Set results_limit between 20 and 2,000 according to the required coverage instead of assuming every showcase contains the default 100 products.
• After success, follow next_cursor while has_more is true so task-result pagination does not leave saved products unread.
• Deduplicate snapshots by product id and treat empty tasks or missing seller, price, media, category, SKU, and metric fields as valid public-source outcomes.

Related APIs