Skip to main content
Breaking changes only ever ship behind a new dated version. Everything else is additive — see Versioning for what that means in practice.
​
API version 2026-09-01 · Preview
The first public version. TikTok Shop across 16 markets, with all six entities.The waterfall — every request cascades across the sources behind a channel in cost order and stops at the first verified result. Misses and unreached steps are not charged.Entities — shop, product, creator, video, livestream and category, each with search, detail and — where it applies — timeseries endpoints.Resolution and enrichment — POST /resolve and POST /enrich take up to 100 inputs per call, accepting URLs, handles and channel-native IDs.Asynchronous work — POST /jobs for bulk enrichment, deep search and CSV or JSONL exports, with job.completed webhooks.Lists and trackers — saved sets with scheduled re-checks and threshold conditions, delivering tracker.triggered events.Platform — cursor pagination, Idempotency-Key on billable writes, signed webhooks, the /coverage endpoint, and a sandbox with deterministic fixtures.
The API is in preview. The schema is stable enough to build against, and this version will be supported for 12 months after its successor ships.
​
Planned, not yet shipped
Directional rather than committed — dates are not promises, and nothing here is safe to build a dependency on until it appears above.
  • More channels. Amazon first, then Shopee and Lazada for Southeast Asia, then Shopify storefronts. Your filters and stored IDs are unaffected when a channel is added.
  • Creator audience demographics. Age, gender and geography distributions, currently in preview behind Unif-Preview: creator-audience-demographics.
  • Ad-attributed revenue. Splitting revenue_by_source further, to separate paid placement from organic.
  • Official SDKs. Node and Python, generated from the same OpenAPI document that produces this reference.