Skip to main content
POST
TikTok Shop Categories API

TikTok Shop Categories

Get the complete category tree of a TikTok Shop market in one call. Each category is a row with its ID, name, English slug, level, parent and the names above it, so the hierarchy can be rebuilt as a tree or used as a flat lookup. Use the IDs with TikTok Shop Category Products to browse a category’s listings, or map the tree to your own catalog for market research.
region is optional and defaults to US; US, SG, MY, PH, TH, VN, ID, JP and MX are available. Each call costs 0.5 credits and returns every category of that market.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

region is optional and defaults to US. Each call returns the full category tree of that market, one row per category, with its level and parent so the tree can be rebuilt.

callback_url
string<uri>
region
enum<string>
default:US

Country or region code of the TikTok Shop market.

Available options:
ID,
JP,
MX,
MY,
PH,
SG,
TH,
US,
VN
Minimum string length: 1

Response

Task accepted

code
integer
data
object