TikTok Category Request

1 credits/call
ae_tiktok_category_request

Query Best Seller products in a TikTok category to support category-market analysis. Provide the required category ID as node_id, for example "601281". Optionally specify site as Unknow, US, MY, PH, VN, TH, ID, GB, or JP (default: Unknow), and page (default: 1; page numbering starts at 1). Each page contains up to 20 products. The provider does not define a response schema, so specific returned fields are not guaranteed.

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Each call queries one page of Best Seller products in the specified category. The site, page number and number of products returned do not affect the fixed per-call charge. Querying another page requires a separate charged call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoPagination, up to 20 products per page. Defaults to page 1 (page index starts from 1, not 0).1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
node_idstringYesThe category ID to query. Example: 601281.—

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_request' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "node_id": "867592",
    "page": 16,
    "site": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": {
    "is_sub_category": true,
    "products": []
  },
  "doc": {
    "is_sub_category": "Whether this is a leaf (sub) category.",
    "products": "Best Seller product list under the category.",
    "products.author_count": "Number of affiliate creators (US site only).",
    "products.brand_name": "Brand name; returns an empty string or the field may be absent when unavailable.",
    "products.category": "Top-level category of the product, as a JSON object.",
    "products.category.Name": "Top-level category name."
  }
}

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

Guides using this tool

See how this tool fits into real workflows