Guides / End-to-end tutorials / TikTok Shop research A–Z
TikTok Shop research A–Z
Scope immutable US and UK TikTok Shop clients, discover category SKUs by keyword, parse mobile SDUI product pricing and stock, paginate verified buyer reviews, and benchmark affiliate showcases.
1. Regional storefront scoping
TikTok Shop catalogs, currency, logistics promises and affiliate commissions are strictly region-bound. Use withMatrix({ appFlavour: 'shop', region: 'US' | 'GB' }) so US and UK calls never cross-pollinate storefront state.
| Action | Endpoint | Cost |
|---|---|---|
| Shop search | GET /v1/shop/search | 25 cr |
| Product page | GET /v1/shop/product-page | 25 cr |
| Product reviews | GET /v1/shop/reviews | 25 cr |
| Seller catalog | GET /v1/shop/seller | 25 cr |
| Creator showcase | GET /v1/shop/showcase | 25 cr |
2. Discovery, SDUI PDP & review pagination
TypeScript SDKPython SDKcURL / MCPshop_research
1import { NotFoundError, TikUltra } from 'tikultra'
2
3const base = new TikUltra({ apiKey: process.env.TIKULTRA_KEY })
4const usShop = base.withMatrix({ os: 'android', appFlavour: 'shop', region: 'US', city: 'los_angeles' })
5const ukShop = base.withMatrix({ os: 'android', appFlavour: 'shop', region: 'GB', city: 'london' })
6const discovery = await usShop.shop.search({ keyword: 'vitamin c serum', count: 20 })
7const leadItem = discovery.data.items?.[0]
8const pdp = await usShop.shop.pdp({ product_id: leadItem.product_id })
9const reviews: Array<Record<string, any>> = []
10for await (const page of usShop.paginate('GET', '/v1/shop/reviews', { params: { product_id: leadItem.product_id, count: 20 }, maxPages: 3 })) {
11 reviews.push(...(page.data.items ?? []))
12}
13const [sellerCatalog, ukShowcase] = await Promise.all([
14 usShop.shop.seller({ seller_id: pdp.data.seller?.seller_id, count: 20 }),
15 ukShop.shop.showcase({ username: 'glowwithava', count: 20 }).catch((e) => (e instanceof NotFoundError ? null : Promise.reject(e))),
16])
17console.log({ skus: (pdp.data.skus ?? []).length, reviews: reviews.length, sellerItems: sellerCatalog.data.items?.length, ukItems: ukShowcase?.data.items?.length ?? 0 })
Premium tier accounting. Each Shop call costs
25 credits on success: 1 search + 1 PDP + 3 review pages + 1 seller catalog + 1 UK showcase = 175 credits. Delisted or region-locked SKUs returning 404 cost 0 credits.