TikTok Category Tree
Look up the TikTok product category hierarchy for a site. Omit node_id to retrieve top-level and second-level categories, or provide a category node ID as a string to retrieve its child categories. Both inputs are optional: site accepts Unknow, US, MY, PH, VN, TH, ID, GB, or JP and defaults to Unknow; node_id defaults to an empty string. The provider does not specify a response schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
The fixed charge per call is the same for every site and whether or not a category node is specified. Without a category node, the query retrieves top-level and second-level categories; with a category node, it retrieves that node’s child categories.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
node_id | string | No | Optional: if specified, returns the child categories of this node_id; if not specified, returns the top-level and second-level categories. Data type: string. | "" |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_category_tree' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"node_id": "871048",
"site": "US"
}
}'{
"data": [
{
"category_name": "TV Stands & Bedside Tables",
"node_id": "877192"
}
],
"doc": {
"category_name": "Category name.",
"children": "Array of child categories; each element contains category_name and node_id.",
"children.category_name": "Category name of the child category.",
"children.node_id": "NodeID of the child category.",
"node_id": "Category NodeID, used as input for subsequent category-scoped product/report/trend/keyword queries."
}
}This example shows part of the response. Copied content is valid JSON.

