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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Pagination, up to 20 products per page. Defaults to page 1 (page index starts from 1, not 0). | 1 |
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
node_id | string | Yes | The category ID to query. Example: 601281. | — |
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_request' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"node_id": "867592",
"page": 16,
"site": "US"
}
}'{
"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

