TikTok Shop API: the official Partner API, and sales data for every shop
TikTok Shop's official API is the Partner API in Partner Center. It runs your own shop: products, orders, fulfillment, finance and analytics for shops that authorize your app. To get sales for any product, shop or creator, competitors included, use the TokConnect API. It's one REST call with an API key, covers 17 markets, and needs no Partner Center approval.
- 50+ TikTok Shop routes, 17 markets
- 1 credit per call, failed calls refunded
- OpenAPI spec, CLI and MCP included
# Which shop is Goli, and what did it sell in 30 days?
curl -H "X-API-Key: $TOKCONNECT_KEY" \
"https://api.tokconnect.com/v1/shops/top?keyword=goli&window=30d"
# first row, trimmed
{
"name": "Goli Nutrition",
"id": "7495794203056835079",
"revenue": "$1.21m",
"sale": 41243,
"revenue_grouping_rate": "8.6%",
"affiliate_revenue": "$937.07k",
"self_promotion_revenue": "$253.43k",
"seller_type": "BRAND"
}
What the official TikTok Shop API does
TikTok Shop calls it the TTS API. It's documented in Partner Center at partner.tiktokshop.com, where the overview says it lets developers access authorized TikTok Shop data. That data belongs to a shop that approved your app.
What it covers
12 API groups, including Product, Order, Fulfillment, Return and Refund, Logistics, Promotion, Finance and Analytics. They're the right tools for running a shop: listing products, syncing orders and stock, and reporting your own GMV.
Who gets access
A seller developer builds a custom app with access to their own shop's data only. An app developer or system integrator can request authorization from other sellers. Every call carries a seller access token.
How long it takes
Registering as a developer is quick, but Partner Center says the compliance and legal review for US and UK partners can take three or more weeks. A seller developer also needs an activated TikTok Shop account first.
The Analytics group has endpoints for shop, video and LIVE performance, and Get Bestselling Products returns up to 100 products ranked by GMV over 1, 7 or 30 days. Since 3 November 2026 TikTok also has seller terms for connecting AI tools to your own shop over MCP. See TikTok Shop MCP. Partner Center pages checked 29 October 2026.
Partner API or TokConnect API: which one you need
Use the Partner API to run your own shop. Use TokConnect to see every other shop. Many teams use both, often joined in n8n.
| TikTok Shop Partner API | TokConnect API | |
|---|---|---|
| Whose data | Shops that authorized your app | Any product, shop, creator, video or LIVE |
| Competitor sales | Only if the competitor authorizes your app | Yes, estimated, for any shop |
| Orders, stock, payouts | Yes, read and write | No |
| Market rankings | Get Bestselling Products: up to 100 products, 1, 7 or 30 days, Level 1 category | About 700 ranked products per keyword, with categories to level 3, filters and sorts, and windows up to 365 days |
| Creators and affiliates | Your shop's affiliate programme | The creators selling any product or shop, with their revenue |
| Markets | Where your shop sells | 17: US, GB, DE, FR, ES, IT, NL, IE, PL, JP, TH, VN, ID, MY, PH, BR, MX |
| Getting started | Partner Center registration, app review, seller authorization | Sign up, copy an API key, call |
| Price | No API fee published | Paid plans from $49 a month, 1 credit per call |
Partner API: TikTok Shop Partner Center overview, developer types, onboarding and Analytics reference pages, checked 29 October 2026. TokConnect: the live API spec at /openapi.json, 16 November 2026. TokConnect figures are estimates.
Quickstart: a competitor's sales in three calls
Every route is a GET on https://api.tokconnect.com/v1, with your key in the X-API-Key header and arguments in the query string. Add region=GB, or any of the 17 market codes, to switch markets.
- Find the shop and its 30-day sales
GET /v1/shops/top?keyword=goli&window=30d - Its best-selling products
GET /v1/shops/7495794203056835079/products?window=30d - The creators selling it
GET /v1/shops/7495794203056835079/creators?window=30d
Other Shop routes include /v1/products/top, /v1/products/{id}/trend, /v1/affiliates/top, /v1/videos/top-selling, /v1/lives/top-selling and /v1/markets. Full list: TikTok Shop data API reference.
What came back for Goli
| Answer | Value |
|---|---|
| 30-day revenue, TikTok Shop US | $1.21M |
| Units | 41,243 |
| Growth on the 30 days before | +8.6% |
| Through affiliate creators | $937.07K (77%) |
| Top product | Zero Sugar Best Seller Trio, $387.21K |
| Top seller | @golinutrition, the brand's own account, $99.75K, mostly LIVE |
TikTok Shop US, estimated, 15 October to 13 November 2026. Revenue is units times the listed price. Source: TokConnect, pulled 15 November 2026.
Call it from code, a CLI or your AI
REST
Any language that can send an HTTP GET. The spec is at /openapi.json, so you can generate a client or import it into Postman.
CLI and Python
The tokconnect package on npm and PyPI wraps every route as a command and a Python client. Developer guide
MCP
The same data inside Claude, ChatGPT or Cursor, with no code: add https://mcp.tokconnect.com/mcp. TikTok Shop MCP
TikTok Shop API questions
Does TikTok Shop have an official API for sales data?
Yes. TikTok Shop's Partner API, the TTS API in Partner Center, includes Analytics endpoints for shop, product, video and LIVE performance, but it returns data for shops that authorized your app. For estimated sales on any product, shop or creator, the TokConnect API returns them over REST and MCP in 17 markets.
Where is the TikTok Shop API documentation?
At partner.tiktokshop.com, in Partner Center's Developer Guide and API Reference. It covers authorization, signing requests, rate limits, webhooks and the API groups. The market-data side, for any shop, is in TokConnect's spec at tokconnect.com/openapi.json and its TikTok Shop data API reference.
How long does it take to get TikTok Shop Partner API access?
Registering as a developer is quick, but Partner Center says the compliance and legal review for US and UK partners can take three or more weeks, and a seller developer needs an activated TikTok Shop account first. A TokConnect API key works as soon as you're on a paid plan.
Can the TikTok Shop API show a competitor's sales?
The Partner API can only if the competitor authorizes your app. Its one market-wide endpoint, Get Bestselling Products, returns up to 100 products by GMV. TokConnect needs no authorization: call /v1/shops/top with the brand's name and you get its estimated 30-day revenue, units, growth and affiliate share.
How much does the TikTok Shop API cost?
TikTok publishes no fee for the Partner API. The TokConnect API is on every paid plan, from $49 a month for 600 credits. Each call costs 1 credit and failed calls are refunded. The free plan's 50 credits work in ChatGPT and Claude over MCP.
Which markets does the TokConnect TikTok Shop API cover?
17 TikTok Shop markets: US, GB, DE, FR, ES, IT, NL, IE, PL, JP, TH, VN, ID, MY, PH, BR and MX. US is the default; pass region with a market code for the others, and /v1/markets lists them with their currencies.
Get TikTok Shop sales for any shop
One API key, 50+ Shop routes, 17 markets.