TikTok Category Tree

1 credits/call
ae_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.

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 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.

ParameterTypeRequiredDescriptionDefault
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site. Unknow
node_idstringNoOptional: 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.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.