stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Summary
The Seller Search Creator on Marketplace and Get Marketplace Creator Performance endpoints add an optional data_groups parameter, letting callers request only the creator data groups they need (basic info / content performance / follower info / collaboration / sales & GMV). If omitted, all groups are returned by default, keeping behavior unchanged — fetching on demand reduces response size and unnecessary data retrieval, improving API efficiency.
§2 Scope of Impact
- Affected endpoints (2): Seller Search Creator on Marketplace, Get Marketplace Creator Performance.
- Applicable markets: EU, UK.
- Applicable seller types: Local and Cross-border.
§3 Field-level Diff
| Field | Before | After |
|---|---|---|
| data_groups | Not present (endpoint always returned all data groups) | New, optional; type []string (enum array); default: returns all groups when omitted (get all groups by default); |
data_groups enum values:
- BASIC_CREATOR_INFORMATION — basic creator information
- CONTENT_PERFORMANCE — content performance
- FOLLOWER_INFORMATION — follower information
- COLLABORATION — collaboration
- SALES_AND_GMV — sales and GMV
§4 Breaking or Not
Non-breaking (backward compatible). This is a new optional parameter; the default behavior (returning all groups) is identical to before. Existing callers keep working with no changes and no migration required.
§5 Timeline
- Effective scope: all versions after 202309 (example endpoints shown are 202508).
- Launch: released with the corresponding versions; no hard deadline (non-breaking change).
§6 Links
- API Reference · Seller Search Creator on Marketplace: Seller Search Creator on Marketplace
- API Reference · Get Marketplace Creator Performance: Get Marketplace Creator Performance