New
✨Explore our latest updates! 📚We're introducing fresh content and a brand-new set of TikTok Shop APIs to our new document library.
Note: All TikTok Shop APIs before version 202309 are considered legacy. You can switch to the legacy document library to access legacy API documentation.
Documents
Getting Started
Partner Guide
Developer Guide
API Reference
Webhooks
Terms and Policies
Changelog
FAQs
API Testing Tool
Changelog
Affiliate
New APIs and webhook for affiliates (beta)
New affiliate messaging APIs
Authorization
Authorization page updates
Fulfillment
New shipping label format launched in the ID, MY and VN markets
For local and cross-border sellers in the US market: Shipping information update time window extended to 72 hours
For local sellers in the UK market: Introducing item level order split shipping
For local sellers in the US market: Warning information added to Mark Package as Shipped API
For the SEA market partner&developer: The parameters "handover_method" in API Ship Package and Batch Ship Package will be useless
When SEA POP sellers add, edit or publish global products by API, some specific categories will be prohibited and restricted directly
BR market: ZPL format support for shipping documents
US market: TikTok Shipping label allocation
Orders
Shortened string length for buyer_email in Get Order Detail API
For US and UK markets: Introducing "On Hold" order status
SLA information now available in Orders API
Delivery instructions now available in Orders API
For US local sellers: Item level tax rate added to the Order resource
For SEA market: Upcoming changes on tracking number availability in Orders API
For US market: Replacement orders now available
For US market: New property address_level field added to Orders API
For UK market: Support item level cancellation
Virtual bundles are now available in order details
For SEA market: Upcoming changes on tracking number availability
Auto Combine Order ID available in Order Details for LIVE sessions
Adding co-founded shipping discount fields
US market: Pre-order, made-to-order, back-order functionality; delivery SLA
US and UK markets: Exchange orders
US market: Fast delivery program
US market: Changes to recipient_address masking
BR and MX markets: Changes to name logic
Order cancellation
US only: Order cancellation workflow updates
Removal of "unable to deliver to buyer address" as a cancellation reason in ID, VN, TH, SG, PH markets
Products
For the SEA Market Partner & Developer: Add Expire Date on Product Certifications
EU GPSR Communication Doc - adding Responsible person, Manufacturer and Safety label information
Updates to Product API Mandatory Certifications
New property added to Recommend Category API to indicate whether sellers can use the recommended category
New property added to Get Category Rules API to indicate whether the package dimension is mandatory
Changes to Check Listing Prerequisite API in v202312
Changes to Create Product and Edit Product APIs
Draft status available for Create Product API
New endpoint: Listing schema
New webhook: Product update
UK market only: Size chart is now mandatory for product listings
For the UK market: Updates to mandatory attributes and product certifications for certain product categories
US market: Product category expansion
US and UK markets: Product information quality APIs
For the TH market: Updates to mandatory attributes and product certifications for certain product categories
New fields added to Product API for Shop Ads
For the TH market: Updates to mandatory certifications for certain product categories
New Promotion APIs: Gift with purchase and free sample
US market: Mandatory hazmat attributes added
US and UK markets: Product category recommendation
For the PH market: Updates to mandatory attributes on fresh and frozen related categories
For the SEA market: Various categories will require the mandatory attribute - "Dangerous Goods"
New webhook: Product creation
Sunsetting listing schemas endpoint
UK market: Mandatory hazmat attributes added
US market: Introducing Listing Quality Tiers (LQT) for products
EU market: Adding compliance required fields to Products API
For the ES and IE market: Updates to Mandatory Certifications for Certain Product Categories
US market: Adding mandatory certificates for Bikes, Scooters and Appliances
HTML Tags are supported in product descriptions
External Product Attribution for Reviews and Ads
US&UK Markets: Hazmat Deadline Extension
Product Audit Status is Added to Products API
Price and Inventory is optional when editing products
New Endpoint: Diagnose and Optimize Product
MX market: Minimum product price adjustment
Product API now supports two prices
Create Product API now supports an idempotency key
Hazmat Deadline Extended to April 15
Mandatory certifications for certain categories added
Upload Product Image and Upload Product File support more file formats
Streamlining of invite-only product categories
US market: Supplementary SKU images
US, UK, and SEA markets: Pre-order and made-to-order product types
US market: Updates to mandatory attributes
Promotion
(MAINTENANCE) Scheduled downtime for Promotion APIs
Finance
US and UK markets: New properties added to Finance API
US market: Adding shipping fee items to Finance API
New version (v202501) for Statement Transactions and Order Statement Transactions
Other
Deprecating TikTok Shop API V1
Introducing API version 202309
Black Friday Cyber Monday campaign developer update
TikTok Shop open API release update - November 2023
Upcoming updates to TikTok Shop open API (release: December 2023/Q1 2024)
Introducing Seller Center development shops
New function: Pre-publish checklist
For US local sellers: Retail delivery fee is added to API
Return amount detail information available in Search Return API
For SEA markets: Introducing development shops
Development shops supports creating accounts for cross-border shops
ARD updates
Adding SKU and product limit to Promotion API
(REMINDER) Legacy API Sunsets on Dec 31, 2024
US market: Removing some reject reasons for returns
ID market: "Tokopedia & Shop" Open API Integration One Pager
BR market: Updated API workflow to support Order, Invoice and Warehouse
JP market: Updated APIs for Products, Orders, Logistics, and Customer service