TikTok Shop Products API

TikTok Shop Products

Features

• Store-scoped catalog controlsCollect products from one supported public store URL with a requested result limit, top or new-releases ordering, and a documented market region.
• Product, seller, and media identityReturn product IDs, titles, available descriptions, canonical URLs, seller or shop identity, and deduplicated public image references in each record.
• Pricing and visible commerce signalsPreserve exposed sale and original prices, currency, formatted values, discounts, ratings, review counts, and sold counts for product comparison.
• Structured catalog rowsKeep available status, category, and SKU structures with normalized product rows while excluding shop-level counters that are not attached to an individual product.

Parameters

How to Use

Submit one public TikTok Shop store URL with optional collection controls, track the asynchronous task, and read normalized product records with cursor pagination.

1. Prepare one supported /shop/store/{slug}/{numeric_shop_id} URL and choose results_limit, sort_by, and region values.
2. POST the request to /v1/tiktok-shop/products and save the returned task_id.
3. Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
4. Read data.results.items and request the returned next_cursor while has_more remains true.

curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'

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

Best Use Cases

• Storefront catalog snapshots: Use product IDs, titles, URLs, sellers, prices, images, categories, SKU structures, and collected_at to assemble a point-in-time public store catalog.
• Top and new-release assortment comparison: Collect the same store with top and new_releases ordering, then compare returned product identity, pricing, categories, and visible product signals.
• Public price and signal tracking: Compare independently collected price, discount, rating, review-count, sold-count, status, and collection-time fields for matching product IDs.
• Product URL shortlist preparation: Use canonical product URLs, titles, images, seller context, and visible metrics to select returned products for detail or review workflows.

Pro Tips

• Validate that the input uses a public tiktok.com /shop/store/ path with a numeric shop ID before submitting the task.
• Set region to the store market you intend to inspect; when a valid store returns no records, verify regional availability before retrying.
• Use top for source best-seller ordering or new_releases for newest-release ordering, and do not interpret either mode as a profitability or trend guarantee.
• Treat results_limit as the collection maximum and continue the separate task-result cursor until has_more is false to read every saved row.
• Key repeated snapshots by product ID, retain collected_at, and handle seller, price, status, category, SKU, media, and metric fields as optional.

Related APIs