快工助手跨境电商知识与商机助手

Bestsellers Analytics Open API Launch

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 Bestsellers Analytics Open API Launch

#

§2 Overview

Overview

This release introduces the Bestsellers Analytics OpenAPI, a set of four new APIs that provide programmatic access to TikTok Shop's Bestsellers rankings from Data Compass. Developers can now retrieve the top 100 products, creators, videos, and LIVE sessions by GMV in the seller's authorized market. Previously, Bestsellers data was only available through the Seller Center web portal with no API access. Third-party data service providers — one of the most influential app categories in the TikTok Shop ecosystem — had no compliant way to access this data. This release enables ISVs across multiple app categories (including Analytics & Reporting, ERP, Connector, Creator collaborations and TikTok Shop Seller apps) to build data-driven features such as trending product discovery, top creator analysis, viral video insights, and competitive benchmarking.

#

§3 What's New

What's New

#

§4 Affected APIs

Affected APIs

NamePathTypeVersionDescription
Get Bestselling Products[GET]/analytics/202511/products/bestsellingRESTful API202511Get the top 100 performing products of the target date range.
Get Bestselling Creators[GET]/analytics/202511/creators/bestsellingRESTful API202511Get the top 100 performing creators of the target date range.
Get Bestselling Videos[GET]/analytics/202511/videos/bestsellingRESTful API202511Get the top 100 performing videos of the target date range.
Get Bestselling LIVEs[GET]/analytics/202511/lives/bestsellingRESTful API202511Get the top 100 performing lives of the target date range.
#

§5 Important Notes

Important Notes

  • Authorization required: All four APIs require a valid seller OAuth access token (x-tts-access-token). The data returned is scoped to the seller's registered market.
  • GMV desensitization: All GMV values are returned as ranges with a random offset applied for privacy protection. Exact GMV figures are not available.
  • Top 100 limit: Each API returns a maximum of 100 records per request.
  • Time granularity: The minimum granularity is daily (1D). Supported time slots are 1D, 7D, and 30D.
  • Currency options: Responses support USD (US dollars) or LOCAL (local currency) via the currency query parameter.
  • API version: All four APIs share the version 202511.
  • Access level: Public — available to all ISVs and sellers who request the Bestsellers scope.
#