tiktok-shop/
categories

The TikTok Shop Categories API retrieves the full product category tree of a TikTok Shop market from an optional region code, one row per category with ID, name, English slug, level, parent and path.

TikTok Shop Categories API

Full category tree
Optional region
Parent and level
Category IDs
0.5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
regionOptionalMarket 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.

  1. POST {"region": "US"} to /v1/tiktok-shop/categories, or leave region out to get the US tree.
  2. Poll GET /v1/tasks/{task_id} until the task has succeeded.
  3. 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.

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.

Explore other platforms

Combine TikTok Shop data with public data from other supported social platforms.

TikTok Shop Categories API — FAQ

TikTok Shop Categories API is a programmatic interface for retrieving the complete product category tree of one TikTok Shop market, selected by an optional region code. It returns each category's ID, name, English slug, parent, level, leaf flag, ancestor path and icon URL.

region accepts US, SG, MY, PH, TH, VN, ID, JP and MX, and defaults to US when it is left out.

Select the rows whose parent_id equals that category's id. A row with is_leaf set to true has no subcategories and marks the end of its branch.

name follows the display language of the market, while slug gives an English URL label for every category, which helps when reading markets in other languages.

Each TikTok Shop Categories API call costs 0.5 credits and returns every category of the market, however many rows the tree has.