stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Overview
We are removing two groups of TikTok Shop Affiliate (Affiliate Seller) APIs: 1、Several historical versions of the 2024 APIs; 2、A set of 2022 legacy affiliate endpoints that have been superseded by newer APIs. Migrate your integration to the corresponding latest version before the removal date to avoid disruption.
§2 Effective date
All listed old versions and legacy endpoints will sunset on 2026-10-12 10:00 (UTC+8). After this time, requests to these endpoints will fail.
§3 Who is affected
| Dimension | Affected scope |
|---|---|
| Markets | All markets |
| Seller types | All seller types |
| Partner app types | All partner apps |
| Integrations | Any integration that calls the deprecated versions or legacy endpoints listed below |
§4 APIs being deprecated
#§5 1. Historical versions of 2024 APIs — upgrade to the latest version
1. Historical versions of 2024 APIs — upgrade to the latest version
The endpoint and behavior stay the same. Upgrade the version number in the request path from the deprecated version to the target version.
| API | Method | Endpoint ({version} is the version segment) | Deprecated version(s) | Target version | API Reference |
|---|---|---|---|---|---|
| Create Open Collaboration | POST | /affiliate_seller/{version}/open_collaborations | 202405 | 202412 | Create Open Collaboration |
| Create Target Collaboration | POST | /affiliate_seller/{version}/target_collaborations | 202405 | 202508 | Create Target Collaboration |
| Get Open Collaboration Creator Content Detail | GET | /affiliate_seller/{version}/open_collaborations/creator_content_details | 202412 | 202508 | Get Open Collaboration Creator Content Detail |
| Query Target Collaboration Detail | GET | /affiliate_seller/{version}/target_collaborations/{target_collaboration_id} | 202412, 202409 | 202508 | Query Target Collaboration Detail |
| Remove Creator From Open Collaboration | POST | /affiliate_seller/{version}/open_collaborations/{open_collaboration_id}/remove_creator | 202405 | 202508 | Remove Creator From Open Collaboration |
| Search Open Collaboration | POST | /affiliate_seller/{version}/open_collaborations/search | 202409 | 202412 | Search Open Collaboration |
| Search Target Collaborations | POST | /affiliate_seller/{version}/target_collaborations/search | 202409 | 202508 | Search Target Collaborations |
| Update Target Collaboration | PUT | /affiliate_seller/{version}/target_collaborations/{target_collaboration_id} | 202409 | 202508 | Update Target Collaboration |
| Get Marketplace Creator Performance | GET | /affiliate_seller/{version}/marketplace_creators/{creator_user_id} | 202505, 202406 | 202508 | Get Marketplace Creator Performance |
| Seller Search Creator on Marketplace | POST | /affiliate_seller/{version}/marketplace_creators/search | 202505, 202406 | 202508 | Seller Search Creator on Marketplace |
| Create Conversation with creator | POST | /affiliate_seller/{version}/conversations | 202412 | 202508 | Create Conversation with Creator |
| Seller Review Sample Applications | POST | /affiliate_seller/{version}/sample_applications/{application_id}/review | 202409 | 202507 | Seller Review Sample Applications |
| Seller Search Sample Applications | POST | /affiliate_seller/{version}/sample_applications/search | 202507, 202409 | 202508 | Seller Search Sample Applications |
§6 2. Legacy 2022 APIs — migrate to the 2024 APIs
2. Legacy 2022 APIs — migrate to the 2024 APIs
These 2022 legacy affiliate endpoints have been superseded by the 2024 APIs and will be removed entirely.
| API | Method | Endpoint ({version} is the version segment) | Description | Replacement endpoint | API Reference |
|---|---|---|---|---|---|
| Get Shop Products (legacy) | GET | /affiliate/{version}/shop_products | Get creator showcase products | /affiliate_creator/202405/showcases/products | Get Showcase Products |
| Generate Affiliate Product Promotion Link | POST | /affiliate_seller/{version}/products/{product_id}/promotion_link/generate | Generate a dedicated affiliate product tracking link | No replacement | Will be removed (no replacement) |
| Check Anchor Content | POST | /affiliate/{version}/anchors/content_check | Check whether an anchor contains non-compliant words | No replacement | Will be removed (no replacement) |
| Get Creator Profile (old) | GET | /affiliate/{version}/profiles | Query creator basic profile | /affiliate_creator/202508/profiles | Get Creator Profile |
| Get Showcase Products (old) | GET | /affiliate/{version}/showcases/products | Query creator showcase products | /affiliate_creator/202405/showcases/products | Get Showcase Products |
| Top Showcase Products (old) | POST | /affiliate/{version}/showcases/products/top | Pin creator showcase products | /affiliate_creator/202409/showcases/products/top | Top Showcase Products |
| Add Showcase Products (old) | POST | /affiliate/{version}/showcases/products | Add creator showcase products | /affiliate_creator/202405/showcases/products/add | Add Showcase Products |
| Remove Showcase Products (old) | DELETE | /affiliate/{version}/showcases/products | Remove creator showcase products | /affiliate_creator/202409/showcases/products | Remove Showcase Products |
| Check Anchor Prerequisites | POST | /affiliate/{version}/anchors/prerequisite_check | Check whether a creator is eligible to add anchors to videos | No replacement | Will be removed (no replacement) |
§7 Action required
This is primarily an API version upgrade, so migration is straightforward. Complete the switch before 2026-10-12:
- Check the two tables above to find which deprecated versions or legacy endpoints your integration uses, along with the target version or replacement endpoint.
- For versioned APIs, update the version segment in the request path to the target version. For legacy APIs, switch to the replacement endpoint; if there is no replacement, stop calling that endpoint. Review the linked API Reference for any request/response field differences.
Example — version upgrade (Create Open Collaboration, request path only):
Before: POST /affiliate_seller/202405/open_collaborations
After: POST /affiliate_seller/202412/open_collaborations
§8 References and support
This deprecation is published on the Developer Changelog. If you have any questions, please submit a Ticket.