TikTok Category Search

1.05 credits/call
ae_tiktok_category_search

Search TikTok e-commerce categories for market research with optional site and category scope. Filter by average selling price, star rating, review count, monthly and cumulative sales counts, monthly sales amount, source shop count, new-product activity, and Top-10 product or seller sales shares. The monthly sales count and amount, cumulative sales count, and source shop count filters refer to the category's Top-300 products. New products are those listed within 3 months. Minimum and maximum bounds are inclusive; share values are percentages (30 means 30%). A category ID includes that category and its subcategories. Pagination starts at page 1 and returns up to 20 categories per page. Result fields are not specified by the provider.

Social
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.05 credits/call

Each call is charged 1.05 AE credits.

The selected site, category scope, filters, page number, and number of categories returned do not change the fixed per-call charge. Requesting another page is a separate billed call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoPagination, up to 20 categories 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_idstringNoOptional. If specified: limit the search scope to the specified category and its sub-categories (the specified nodeId is not limited to leaf categories). Example: 601281.—
avg_star_maxnumberNoOptional. If specified: filter categories whose average star rating is less than or equal to this value (val <= setting value). Example: 4.9.0
avg_star_minnumberNoOptional. If specified: filter categories whose average star rating is greater than or equal to this value (val >= setting value). Example: 4.0.0
avg_price_maxnumberNoOptional. If specified: maximum average selling price (val <= setting value). Example: 100.00.0
avg_price_minnumberNoOptional. If specified: minimum average selling price (val >= setting value). Example: 10.00.0
avg_review_count_maxintegerNoOptional. If specified: filter categories whose average review count is less than or equal to this value (val <= setting value). Example: 5000.0
avg_review_count_minintegerNoOptional. If specified: filter categories whose average review count is greater than or equal to this value (val >= setting value). Example: 10.0
new_product_count_maxintegerNoOptional. If specified: maximum count of new products listed within 3 months (val <= setting value). Example: 50.0
new_product_count_minintegerNoOptional. If specified: minimum count of new products listed within 3 months (val >= setting value). Example: 1.0
source_shop_count_maxintegerNoOptional. If specified: filter categories whose Top-300 products come from at most this many shops (val <= setting value). Example: 100.0
source_shop_count_minintegerNoOptional. If specified: filter categories whose Top-300 products come from at least this many shops (val >= setting value); fewer shops means stronger shop monopoly. Example: 5.0
monthly_sale_count_maxintegerNoOptional. If specified: maximum monthly sales count of the category's Top-300 products (val <= setting value). Example: 100000.0
monthly_sale_count_minintegerNoOptional. If specified: minimum monthly sales count of the category's Top-300 products (val >= setting value). Example: 1000.0
monthly_sale_amount_maxnumberNoOptional. If specified: maximum monthly sales amount of the category's Top-300 products (val <= setting value). Example: 1000.0
monthly_sale_amount_minnumberNoOptional. If specified: minimum monthly sales amount of the category's Top-300 products (val >= setting value). Example: 100.0
cumulative_sale_count_maxintegerNoOptional. If specified: maximum cumulative sales count of the category's Top-300 products (val <= setting value). Example: 500000.0
cumulative_sale_count_minintegerNoOptional. If specified: minimum cumulative sales count of the category's Top-300 products (val >= setting value). Example: 5000.0
new_product_monthly_sale_count_maxintegerNoOptional. If specified: maximum monthly sales count of new products listed within 3 months (val <= setting value). Example: 10000.0
new_product_monthly_sale_count_minintegerNoOptional. If specified: minimum monthly sales count of new products listed within 3 months (val >= setting value). Example: 100.0
new_product_monthly_sale_amount_maxnumberNoOptional. If specified: maximum monthly sales amount of new products listed within 3 months (val <= setting value). Example: 5000.0
new_product_monthly_sale_amount_minnumberNoOptional. If specified: minimum monthly sales amount of new products listed within 3 months (val >= setting value). Example: 1000.00.0
new_product_monthly_sale_count_share_ratio_maxnumberNoOptional. If specified: maximum monthly-sales share of new products listed within 3 months (val <= setting value), in %. Example: 30 means 30%.0
new_product_monthly_sale_count_share_ratio_minnumberNoOptional. If specified: minimum monthly-sales share of new products listed within 3 months (val >= setting value), in %. Example: 10 means 10%.0
top10_product_weekly_sale_count_share_ratio_maxnumberNoOptional. If specified: maximum Top-10 product weekly sales share (val <= setting value), in %. Example: 60 means 60%.0
top10_product_weekly_sale_count_share_ratio_minnumberNoOptional. If specified: minimum Top-10 product weekly sales share (val >= setting value), in %. Example: 10 means 10%.0
top10_seller_monthly_sale_count_share_ratio_maxnumberNoOptional. If specified: maximum Top-10 seller monthly sales share (val <= setting value), in %. Example: 50 means 50%.0
top10_seller_monthly_sale_count_share_ratio_minnumberNoOptional. If specified: minimum Top-10 seller monthly sales share (val >= setting value), in %; larger means stronger seller monopoly. Example: 10 means 10%.0
top10_product_monthly_sale_count_share_ratio_maxnumberNoOptional. If specified: maximum Top-10 product monthly sales share (val <= setting value), in %. Example: 60 means 60%.0
top10_product_monthly_sale_count_share_ratio_minnumberNoOptional. If specified: minimum Top-10 product monthly sales share (val >= setting value), in %; larger means stronger product sales monopoly. Example: 10 means 10%.0

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_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "node_id": "941448",
    "page": 1,
    "site": "PH"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "avg_price": 807.07,
      "avg_price_mom": 127.58,
      "avg_review_count": 278,
      "avg_star": 4.53,
      "avg_variation_count": 3,
      "name": "Car Battery Repair Tools"
    }
  ],
  "doc": {
    "avg_price": "Average selling price, in the site's local currency.",
    "avg_price_mom": "Month-over-month growth of the average price (%); negative means declining.",
    "avg_review_count": "Average review count.",
    "avg_star": "Average star rating.",
    "avg_variation_count": "Average variation count.",
    "name": "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