TikTok Shop Fetch Products Category List

2.07 credits/call
ae_tiktok_shop_fetch_products_category_list

用途:获取指定地区的商品分类树。参数:`region` 为可选地区代码,默认 `US`;支持 US、SG、MY、PH、TH、VN、ID、JP、MX,GB 和 BR 暂不支持。返回:响应 `data` 是分类节点数组。每个节点包含 `self`(分类信息)和 `children`(子分类数组);叶节点的 `children` 为空。`self.category_id` 为字符串,分类数量和层级因地区而异。

Productivity
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
regionstringNo地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable.US

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_shop_fetch_products_category_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "region": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": [
    {
      "children": [
        {
          "children": [],
          "self": {
            "category_id": "849032",
            "category_level": 2,
            "category_name": "Hand & Foot Care",
            "category_name_en": "hand-foot-care",
            "image_url": "https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/dc05090b19cd43eeac83330f8eb57ac5~tplv-omjb5zjo8w-resize-jpeg:200:200.image?",
            "is_leaf": false
          }
        }
      ],
      "self": {
        "category_id": "601450",
        "category_level": 1,
        "category_name": "Beauty & Personal Care",
        "category_name_en": "beauty-personal-care",
        "image_url": "https://lf16-tiktok-common.tiktokcdn-us.com/obj/tiktok-web-common-tx/i18n_ecom_fe/tiktok_shop_web_mono/apps/homepage_desktop/static/image/beauty-personal.fdbc446c.png",
        "is_leaf": false
      }
    }
  ],
  "docs": "https://api.tikhub.io/#/TikTok-Shop-Web-API/fetch_products_category_list_api_v1_tiktok_shop_web_fetch_products_category_list_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "44247243-f0e8-4f70-ae88-f505b92e9ecd"
}

This example shows part of the response. Copied content is valid JSON.