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

For All Markets : Deprecating the Creator Search Affiliate Trace Orders API

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 Summary

The Creator Search Affiliate Trace Orders API will be fully retired on <span style="color: #D83931">2026-08-15</span><span style="color: #D83931"><strong> </strong></span>; all partners must complete migration before this date to avoid integration failures. This API allowed partners to retrieve a list of affiliate orders generated by a creator, returning the order ID and product ID, so that partners could track affiliate conversions on behalf of a creator. Going forward, developers should migrate to the Search Creator Affiliate Orders API, which provides the same capability of retrieving a creator's affiliate orders for tracking affiliate conversions.

#

§2 What is changing?

The Creator Search Affiliate Trace Orders API will be retired and replaced by the Search Creator Affiliate Orders API. The response payload remains the same; the main differences lie in the endpoint path, version, and the time-filter query parameters, as summarized below.

#

§3 Endpoint

Endpoint

Deprecated APIReplacement API
NameCreator Search Affiliate Trace OrdersSearch Creator Affiliate Orders
EndpointPOST /affiliate_creator/202505/orders/trace/searchPOST /affiliate_creator/202410/orders/search
Version202505202410
Time-filter parameterstime_ge / time_lt / time_typecreate_time_ge / create_time_lt
#

§4 What markets & sellers are affected?

What markets & sellers are affected?

This change applies globally and affects:

  • Markets: All markets where the affiliate program is available (both cross-border and local).
  • Seller types: All seller types (both cross-border and local sellers).
  • Affected callers: All partners and developers currently calling the Creator Search Affiliate Trace Orders API to retrieve a creator's affiliate orders.
#

§5 Required Actions

All developers currently using the Creator Search Affiliate Trace Orders API must migrate to the Search Creator Affiliate Orders API before <span style="color: #D83931"><strong>2026-08-15</strong></span>. Failure to migrate by the sunset date will result in API call failures. The migration involves the following three steps:

  1. Switch the endpoint from POST /affiliate_creator/202505/orders/trace/search to POST /affiliate_creator/202410/orders/search.
  2. Replace the time_ge / time_lt / time_type parameters with create_time_ge / create_time_lt.
  3. Verify that your integration correctly parses the response payload. The response fields are identical to the deprecated API — no other field differences are expected.
#