来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 2026 July TikTok Shop API Updates Summary
Below is a summary of TikTok Shop Open API updates for July 2026. One of these updates is a Breaking Change (Affiliate legacy versions and endpoints sunset), and several category-level mandatory attribute and certification requirements will take effect starting in August. Please prioritize impact assessment and complete the required migrations and field updates according to each market's effective date.
For the full record, refer to the Changelog at the end of this document.
§2 1. Breaking Changes and Key Updates
1. Breaking Changes and Key Updates
| Update | Required Actions | Key Date |
|---|---|---|
| [Breaking] Affiliate API — Legacy Versions and Endpoints Sunset Several historical versions of the 2024 APIs must be upgraded to the latest version; a set of 2022 legacy Affiliate endpoints will be removed entirely, some without a replacement. | · Review whether your integration still calls the deprecated versions or legacy endpoints. · For versioned APIs, upgrade the version segment in the request path to the target version. · For legacy endpoints, switch to the replacement; stop calling those with no replacement. · Regression-test request/response field differences. | Sunset on 2026-10-12 10:00 (UTC+8) |
| [Action Required] Thailand TIS Mandatory Attributes and Certificate Mark 13 categories must add the TIS certificate mark on the product label; several categories add mandatory TIS attributes. Non-compliance blocks product creation/editing. | · Use the Get Category Rules API to confirm mandatory requirements. · Add the TIS certificate mark to the certifications parameter in Create/Edit Product. · Complete the related TIS mandatory attributes. | Effective August 5, 2026 |
| [Action Required] MY Household Appliances / SEA Baby&Maternity & Automotive Mandatory Attributes MY adds mandatory attributes to Household Appliances; SEA adds Recommended Age and Baby Life Stage to Baby&Maternity, and Applicable Brand and Model to Automotive&Motorcycle. | · Identify affected products by market and category. · Complete the corresponding mandatory attributes before listing or editing products via API. | Effective August 1, 2026 |
| [Action Required] Philippines Pest Control Certification FPA → FDA Certification for the Pest Control category changes from the FPA Handler's License to the FDA Certificate of Product Registration (CPR), written into the certifications parameter. Affects both cross-border and local sellers. | · Use the Get Category Rules API to confirm certification requirements. · Switch Pest Control certification to the FDA CPR; otherwise products cannot be created/updated. | Effective September 22, 2026 |
§3 2. Featured New Capabilities (Highly Recommended)
2. Featured New Capabilities (Highly Recommended)
The platform introduced two capabilities this month, covering developer integration efficiency and shop performance diagnosis. They reduce integration and troubleshooting costs while helping sellers and partners locate issues faster and reuse operating assets. Priority review is recommended.
1. TTS Open Toolkit Is Now Available, Making Your AI Assistant "Fluent" in TTS Integration
TTS Open Toolkit is a CLI for TikTok Shop OpenAPI developers. It installs and updates TTS OpenAPI skills for your AI coding agent, connects App and Shop context, helps complete required scopes, and validates supported API calls after authorization — so you can integrate and troubleshoot faster.
The primary value is to embed TTS integration expertise into your AI assistant, significantly reducing integration and debugging costs, and is especially useful for new integrations and frequent troubleshooting.
Recommended for: all developers and partners integrating or maintaining TikTok Shop APIs. View integration guide
2. Shop Performance Score (SPS) APIs for US Shops Are Now Available — Programmable Performance Diagnosis
Five new APIs are added for US-region shops, allowing apps to retrieve an SPS overview, metric details, and single-metric diagnosis, and to drill down into the associated products, logistics providers, aftersales types, orders, or chats. They currently cover six metrics: NRR, NBFR, SFCR, OTDR, AHT, and IM_DSAT.
This capability brings shop performance data that previously required portal review into your own systems, supporting performance diagnosis, issue localization, and merchant recommendations, helping partners move from after-the-fact review to proactive alerting.
Integration notes: requires the data.shop_analytics.public.read scope and shop_cipher in each request; call Overview first, then Metrics and Diagnosis. US-region shops only. View integration guide
§4 3. Other Updates
3. Other Updates
| API Category | Update Summary | Details |
|---|---|---|
| Product API | Customer purchase limits configuration | Create / Edit / Get Product support the optional purchase_order_quantity_limit (maximum_order_quantity per-order limit, cumulative_order_quantity cumulative limit), aligning API capabilities with Seller Center PC. BR and MX are planned for full launch; other regions follow whitelist control. |
| Product API | US POD Customization Config APIs | Print-on-Demand customization for Made-to-Order products can now be configured through the Product APIs: upload customization assets (background, mask, default images), submit template configurations, and read them back. The change is additive; non-POD products do not need to send pod_info. |
| Order API | US & UK Replacement Orders | US/UK buyers can request a replacement shipment while keeping the original item under eligible conditions; the Return API adds related fields. Effective July 8, 2026. |
| Order API | US & UK Exchange Orders | Buyers can initiate an exchange through the return journey to help sellers save GMV; the Return API adds related fields. Effective July 8, 2026. |
| Order API | US room_id in Order APIs | Selected Order API responses add room_id to identify the LIVE session where an order line item was created, helping LIVE order sorting, reconciliation, and fulfillment. Effective July 8, 2026. |
| Order API | US POD customization details available | The order side can now read Print-on-Demand customization details for order items, working together with the product-side POD configuration capability. |
| Order API | US 4PL orders recipient masking | TikTok Shop plans to mask the recipient phone number and detailed shipping address for US 4PL (TikTok-managed shipping) orders, affecting apps that read order data from the Order APIs. Tentatively mid-August 2026. |
| Fulfillment / FBT API | FBT Goods create/update field changes (v202607) | Create / Update FBT Goods add four groups of optional fields — SIOC, bulky-item accessory, goods safety attributes, and aerosol hazmat info — and remove return_cycle and return_address_info under shelf_life_attribute_info. Staying on 202603 requires no changes; migrating to 202607 requires request-body adjustments. |
| Fulfillment / FBT API | Create FBT MCF Order parameter relaxed | The district_or_county parameter of Create FBT MCF Order changes from required to optional; existing integrations are unaffected. |
| Finance API | New properties added to transaction APIs | Get Transactions by Order, Get Transactions by Statement, and Get Unsettled Transaction add new return properties. The change is additive and backward compatible, with no existing field removed or modified. |
| Affiliate API | Marketplace Creator API adds an optional parameter | Seller Search Creator on Marketplace and Get Marketplace Creator Performance 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 and behavior is unchanged. |
| Affiliate API | Indonesia Get Toko Product Mappers API | A new API that converts Tokopedia (Toko) product IDs into their corresponding TikTok Shop product IDs, designed for affiliate / rebate partners who operate on Toko product identifiers. |
| Promotion API | New Republish Activity API | The Promotion category adds a new Republish Activity API that lets sellers bring an expired or deactivated promotion (product discount or flash deal) back online for a new effective period in a single call, without recreating the activity or re-associating products and SKUs. Available in all markets. |
| Other | Post Shoppable Video/Photos APIs new fields (v202607) | Post Shoppable Video adds a request field video_info.is_ai_generated (when true, the published post displays an AI-generated label); both Post Shoppable Video and Photos add a response field quota. |
§5 References
References
- Changelog: https://partner.tiktokshop.com/docv2/changelog
- API Documentation: https://partner.tiktokshop.com/docv2/
If you have any questions about the updates above or need support, please submit a ticket to contact us. Thank you.