Guide

Markets

TikTok Shop data covers 17 markets. Pass the country code as region and amounts come back in that market's currency. Leave it out and you get the US.

The 17 markets

region	Market	Currency
`US`	United States	`USD`
`GB`	United Kingdom	`GBP`
`DE`	Germany	`EUR`
`FR`	France	`EUR`
`ES`	Spain	`EUR`
`JP`	Japan	`JPY`
`TH`	Thailand	`THB`
`VN`	Vietnam	`VND`
`ID`	Indonesia	`IDR`
`MY`	Malaysia	`MYR`
`PH`	Philippines	`PHP`
`BR`	Brazil	`BRL`
`MX`	Mexico	`MXN`
`PL`	Poland	`PLN`
`IT`	Italy	`EUR`
`NL`	Netherlands	`EUR`
`IE`	Ireland	`EUR`

Using region

58 routes take region: the rankings, categories, and the sales, trend, creator and video data on one product, shop, creator, video or LIVE. Any other country code is refused with a 400.

curl "https://api.tokconnect.com/v1/products/top?keyword=lip%20oil&region=DE" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/products/top",
    params={
        "keyword": "lip oil",
        "region": "DE",
    },
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])

const params = new URLSearchParams({
  keyword: "lip oil",
  region: "DE",
});
const res = await fetch(`https://api.tokconnect.com/v1/products/top?${params}`, {
  headers: { "X-API-Key": process.env.TOKCONNECT_API_KEY },
});
if (!res.ok) throw new Error((await res.json()).error?.message);
const { data, next_cursor } = await res.json();

Routes that read TikTok live, like search, a creator's posts or a product page, show what TikTok shows. The live storefront routes read the US store. GET /v1/markets returns this list with each market's currency and language, so your code can read it instead of hard-coding it.