TikTok Shop Products API

TikTok Shop Products

主要特性

• 店铺范围的目录控制通过一个受支持的公开店铺 URL 采集商品，并设置结果上限、热销或新品排序以及已记录的市场地区。
• 商品、卖家与媒体身份每条记录返回商品 ID、标题、可用说明文字、规范 URL、卖家或店铺身份，以及去重后的公开图片引用。
• 价格与可见商品信号保留公开来源提供的售价、原价、币种、格式化价格、折扣、评分、评价数和已售数量，用于商品比较。
• 结构化商品记录在标准化商品行中保留可用状态、分类和 SKU 结构，但不纳入未附着到单个商品的店铺级计数。

参数

如何使用

提交一个公开 TikTok Shop 店铺 URL 和可选采集控制项，跟踪异步任务，并通过 cursor 分页读取标准化商品记录。

1. 准备一个受支持的 /shop/store/{slug}/{数字店铺 ID} URL，并选择 results_limit、sort_by 和 region。
2. 向 /v1/tiktok-shop/products 发送 POST 请求，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
4. 读取 data.results.items；has_more 为 true 时继续使用返回的 next_cursor。

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"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 保存店铺商品目录快照： 结合商品 ID、标题、URL、卖家、价格、图片、分类、SKU 结构和 collected_at，形成某个时间点的公开店铺目录。
• 比较热销与新品商品组合： 分别使用 top 和 new_releases 采集同一店铺，再比较返回的商品身份、价格、分类与可见商品信号。
• 跟踪公开价格与商品信号： 按相同商品 ID 比较独立采集的价格、折扣、评分、评价数、已售数量、状态和采集时间字段。
• 整理商品 URL 候选： 结合规范商品 URL、标题、图片、卖家信息和可见指标，选择需要继续获取详情或评价的商品。

使用建议

• 提交前确认输入是公开 tiktok.com /shop/store/ 路径，并包含数字店铺 ID。
• 将 region 设置为需要检查的店铺市场；有效店铺没有返回记录时，先核对地区可用性再重试。
• 需要来源热销排序时使用 top，需要新品排序时使用 new_releases；不要将任一排序理解为利润或趋势保证。
• 将 results_limit 视为采集上限，并继续读取独立任务结果 cursor，直到 has_more 为 false，避免漏掉已保存商品。
• 使用商品 ID 关联重复快照、保留 collected_at，并将卖家、价格、状态、分类、SKU、媒体和指标字段按可空值处理。

相关 API