TikTok Shop Categories
TikTok Shop Categories are the product taxonomy of a market, where every category has an ID, a local-language name, an English slug, a depth level, a parent and the chain of names above it. Laid out as a tree, they show how a market groups its products and supply the IDs needed to map catalogues, plan category research and browse a single branch.
TikTok Shop Categories API Features
- Every category in one callA single request returns the whole tree of the chosen market, from top-level verticals down to the deepest subcategories, each as its own row.
- Parent, level and leaf flagsparent_id links each row to the category above it, level counts depth from 1 at the top, and is_leaf marks categories with no subcategories.
- Ancestor names in pathIn the TikTok Shop Categories API, path lists the names of every category above a row from the top level down, so a deep category can be shown in context without walking the tree.
- IDs that open a category's productsEach id can be passed as category_id to TikTok Shop Category Products to list the products filed under that category.
TikTok Shop Categories API Parameters
| Parameters | Required | Description |
|---|---|---|
region | Optional | Market whose category tree to return: US, SG, MY, PH, TH, VN, ID, JP or MX. Defaults to US. |
How to Use the TikTok Shop Categories API
Request one market's tree from the TikTok Shop Categories API and assemble it from the returned rows.
- POST {"region": "US"} to /v1/tiktok-shop/categories, or leave region out to get the US tree.
- Poll GET /v1/tasks/{task_id} until the task has succeeded.
- Collect every row from results.items, following results.next_cursor while has_more is true, then nest the rows by parent_id.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"US"}'TikTok Shop Categories API Use Cases
- Rebuilding the category menu: Nest rows by parent_id and order them by level to recreate the market's category navigation, using name for labels and cover_url for icons.
- Mapping to your own catalogue: Match the name, slug and path from the TikTok Shop Categories API against your product categories to translate between your taxonomy and the one TikTok Shop uses in that market.
- Planning a category sweep: Filter the rows under a chosen vertical where is_leaf is true to build the list of IDs to send to TikTok Shop Category Products.
TikTok Shop Categories API Pro Tips
- When has_more is true, follow results.next_cursor to the last page before building the tree, since a missing page leaves child rows without their parent.
- Treat TikTok Shop Categories API rows with an empty parent_id and level 1 as the roots of the tree; their path is an empty list.
- Send category IDs to TikTok Shop Category Products with the same region the tree was read from, because each tree belongs to one market.
Related APIs
Beyond the TikTok Shop Categories API, use these APIs when you need a different type of public TikTok Shop data.
- TikTok Shop Search API — Search public TikTok Shop products by keyword and market region with seller, price, media, rating, review, and sold-count fields.
- TikTok Shop Products API — Collect public products from one TikTok Shop store URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop Product API — Retrieve one public TikTok Shop product from a PDP URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop User Showcase API — Collect public showcase products for one TikTok username with price, seller, media, rating, review, sold-count, and regional context.
- TikTok Shop Hot Products API — Collect a TikTok Shop market's hot-selling products by region code, in ranking order, with price, currency, units sold, rating and shop.
- TikTok Shop Category Products API — List the products of one TikTok Shop category by category ID and market with price, units sold, rating, reviews and shop.