TikTok Shop API
搜索公开商品，采集店铺目录、商品详情、消费者评价和达人橱窗（User Showcase），通过统一异步流程获得可直接分析的标准化电商数据。
可用的 TikTok Shop API
从商品发现、店铺采集和单品补全，到评价分析与达人选品，选择与当前任务匹配的 API。
可以获取哪些 TikTok Shop 数据？
SocQ 将公开的 TikTok Shop 商品与评价结果转换为统一记录，便于研究、监测和接入数据管道。
商品发现与店铺目录
按关键词和区域发现公开商品，或从已知的 TikTok Shop 店铺 URL 采集商品目录。
商品与卖家信息
获取商品身份、卖家、价格、折扣、图片、类目、SKU、评分、评价数和已售数量等可见信息。
公开评价数据
采集评价文本、评分、图片、时间、SKU、国家，以及来源明确提供的购买状态标记。
用户与达人橱窗
按 TikTok 用户名采集公开展示商品，用于分析选品组合、价格区间、品牌和可见互动信号。
SocQ 与 TikTok Shop 开发者产品对比
SocQ 专注于受支持的公开数据采集和标准化记录；需要商家授权或官方店铺与电商操作时，应使用 TikTok Shop 官方开发者产品。
| 能力 | SocQ | TikTok Shop 开发者产品 |
|---|---|---|
| 主要用途 | 受支持的 TikTok Shop 公开数据采集与标准化 | 在对应 TikTok Shop 产品和审核范围内进行官方商家集成 |
| 鉴权 | SocQ API key | TikTok Shop 开发者凭据和适用的商家授权流程 |
| 店铺与电商操作 | 不创建、编辑、发布、下架、定价、备货、履约或管理 TikTok Shop 商品与订单 | 取决于获批的官方产品和权限 |
| 私密或受限数据 | 不支持 | 受官方产品、商家授权和平台政策限制 |
| 响应格式 | 标准化 SocQ 记录 | 对应产品的原生响应 |
TikTok Shop API 如何工作
五个接口共用提交任务、轮询状态和读取结果的异步流程。
1. 选择任务与输入
根据接口准备商品关键词、公开店铺 URL、商品详情页 URL 或 TikTok 用户名。
2. 提交并保存任务 ID
将输入及可选的区域和结果数量参数发送到对应接口，并保存返回的 task_id。
3. 轮询并读取结果
轮询 /v1/tasks/{task_id} 直至完成，从 data.results.items 读取结果，并在 has_more 为 true 时继续传入 next_cursor。
使用 SocQ API key 鉴权并提交一个商品关键词。已有店铺 URL、商品详情页 URL 或 TikTok 用户名时，可切换到对应接口。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取结果，并在 has_more 为 true 时继续传入 next_cursor常见 TikTok Shop 使用场景
商品与趋势研究
按关键词和市场发现公开商品，比较选品、价格区间和可见需求信号。
店铺与竞品监测
保存公开店铺的商品目录快照，持续比较上架商品、价格、折扣和选品变化。
商品与评价分析
结合商品详情、评分、评价文本、图片、SKU 和购买状态标记分析消费者反馈。
达人选品研究
采集公开达人橱窗，分析展示商品、卖家、品牌、价格和可见互动信号。
限制与公开数据政策
TikTok Shop 返回的是采集时的公开记录，结果受区域、可见性、可用性和来源覆盖范围影响。
- 接口仅采集公开数据。私密、已下架、不可用或受区域限制的商品与评价可能不会产生记录。
- 受支持的接口默认使用 US 区域。商品可用性、价格、排序和评价可见性可能因市场而异，并在采集后发生变化。
- results_limit 只是数量上限，不保证返回相同数量的结果；来源未公开时，卖家、价格、媒体、SKU、评价和购买状态字段可能为空。
- SocQ 是只读的公开数据服务，并非 TikTok 官方 API，不会修改商品、评价、达人橱窗、库存、价格、配送或履约设置。
TikTok Shop API 常见问题
什么是 TikTok Shop API？
TikTok Shop API 是一组用于搜索和采集公开商品、店铺目录、商品详情、评价及达人橱窗的 SocQ API。SocQ 会将受支持的结果转换为统一记录，便于分析和接入数据流程。
应该选择哪个 TikTok Shop API？
按关键词发现商品使用 Search，采集公开店铺目录使用 Products，补全一个已知商品使用 Product，采集消费者评价使用 Product Reviews，分析公开用户或达人展示的商品使用 User Showcase。
是否需要连接 TikTok 账号？
不需要客户 TikTok OAuth。请求使用 SocQ API key 鉴权。SocQ 并非 TikTok 官方 API，仅访问受支持的公开数据。
TikTok Shop API 如何计费？
Search、Products、Product 和 User Showcase 每条返回记录消耗 0.7 SocQ 积分，Product Reviews 每条已保存评价消耗 0.3 积分，空结果不收取结果费用。