Temu Category Search

1.05 credits/call
ae_temu_category_search

Search Temu categories for market research using optional site, category-scope, and minimum/maximum metric filters. Filter by Top-100 product prices, monthly sales volume and amount, month-over-month sales growth, average ratings and review counts, brand and seller counts, star sellers, and semi-managed shop counts and sales. New-product filters use products launched within 30 days among the Top-600; additional sales-share filters help screen product and seller concentration. Choose site Unknown, US, or EU (default Unknown), optionally restrict the search to a category and its subcategories, and browse pages of 20 records starting at page 1. Enter percentages as 40 for 40%; sales growth may be negative. This is a category search, not an individual product search. Response fields are not specified by the provider.

Productivity
1.05 credits/call

Pricing

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

Each call is charged 1.05 AE credits.

Each request queries one page; requesting another page incurs a separate call charge. The number of returned records does not affect the charge. The site, category scope and metric filters do not affect the fixed charge per call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
siteenum (Unknown | US | EU)NoTemu site.Unknown
node_idstringNoOptional. If specified, restricts the search scope to the specified category and its sub-categories (the specified category nodeId is not limited to leaf categories).""
price_maxnumberNoOptional. If specified, filters categories whose Top-100 product price is less than or equal to this value.0
price_minnumberNoOptional. If specified, filters categories whose Top-100 product price is greater than or equal to this value.0
avg_star_maxnumberNoOptional. If specified, filters categories whose Top-100 average star rating is less than or equal to this value.0
avg_star_minnumberNoOptional. If specified, filters categories whose Top-100 average star rating is greater than or equal to this value.0
sale_count_maxintegerNoOptional. If specified, filters category markets whose Top-100 product monthly sales volume is less than or equal to this value; a larger value indicates higher product sales concentration.0
sale_count_minintegerNoOptional. If specified, filters category markets whose Top-100 product monthly sales volume is greater than or equal to this value; a larger value indicates higher product sales concentration.0
brand_count_maxintegerNoOptional. If specified, filters categories whose Top-100 distinct brand count is less than or equal to this value.0
brand_count_minintegerNoOptional. If specified, filters categories whose Top-100 distinct brand count is greater than or equal to this value.0
sale_amount_maxnumberNoOptional. If specified, filters categories whose Top-100 monthly sales amount is less than or equal to this value.0
sale_amount_minnumberNoOptional. If specified, filters categories whose Top-100 monthly sales amount is greater than or equal to this value.0
seller_count_maxintegerNoOptional. If specified, filters categories whose Top-100 distinct seller count is less than or equal to this value.0
seller_count_minintegerNoOptional. If specified, filters categories whose Top-100 distinct seller count is greater than or equal to this value.0
sale_count_mom_maxnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%), negative values are allowed. Filter categories whose Top-100 monthly sales month-over-month growth rate is less than or equal to this value; a larger value indicates faster growth.0
sale_count_mom_minnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%), negative values are allowed. Filter categories whose Top-100 monthly sales month-over-month growth rate is greater than or equal to this value; a larger value indicates faster growth.0
avg_review_count_maxnumberNoOptional. If specified, filters categories whose Top-100 average review count is less than or equal to this value.0
avg_review_count_minnumberNoOptional. If specified, filters categories whose Top-100 average review count is greater than or equal to this value.0
new_product_count_maxintegerNoOptional. If specified, filters categories whose Top-600 new product count (launched within 30 days) is less than or equal to this value.0
new_product_count_minintegerNoOptional. If specified, filters categories whose Top-600 new product count (launched within 30 days) is greater than or equal to this value.0
star_seller_count_maxintegerNoOptional. If specified, filters categories whose Top-100 star seller count is less than or equal to this value.0
star_seller_count_minintegerNoOptional. If specified, filters categories whose Top-100 star seller count is greater than or equal to this value.0
new_product_sale_count_maxintegerNoOptional. If specified, filters categories whose Top-600 new product (within 30 days) monthly sales volume is less than or equal to this value.0
new_product_sale_count_minintegerNoOptional. If specified, filters categories whose Top-600 new product (within 30 days) monthly sales volume is greater than or equal to this value.0
sale_count_share_ratio_maxnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter categories whose Top-100 to Top-600 monthly sales ratio is less than or equal to this value; higher means more concentrated in the Top-100, lower means a long-tail category.0
sale_count_share_ratio_minnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter categories whose Top-100 to Top-600 monthly sales ratio is greater than or equal to this value; higher means more concentrated in the Top-100, lower means a long-tail category.0
semi_managed_shop_count_maxintegerNoOptional. If specified, filters categories whose Top-100 semi-managed shop count is less than or equal to this value.0
semi_managed_shop_count_minintegerNoOptional. If specified, filters categories whose Top-100 semi-managed shop count is greater than or equal to this value.0
semi_managed_shop_sale_count_maxintegerNoOptional. If specified, filters categories whose Top-100 semi-managed shop monthly sales volume is less than or equal to this value.0
semi_managed_shop_sale_count_minintegerNoOptional. If specified, filters categories whose Top-100 semi-managed shop monthly sales volume is greater than or equal to this value.0
star_seller_monthly_sale_count_maxintegerNoOptional. If specified, filters categories whose Top-100 star seller monthly sales volume is less than or equal to this value.0
star_seller_monthly_sale_count_minintegerNoOptional. If specified, filters categories whose Top-100 star seller monthly sales volume is greater than or equal to this value.0
new_product_sale_count_share_ratio_maxnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter categories whose Top-600 new product (within 30 days) monthly sales share is less than or equal to this value.0
new_product_sale_count_share_ratio_minnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter categories whose Top-600 new product (within 30 days) monthly sales share is greater than or equal to this value.0
top10_seller_sale_count_share_ratio_maxnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Among Top-100 products, filter categories whose Top-10 seller sales share is less than or equal to this value; higher means stronger seller concentration.0
top10_seller_sale_count_share_ratio_minnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Among Top-100 products, filter categories whose Top-10 seller sales share is greater than or equal to this value; higher means stronger seller concentration.0
top10_product_sale_count_share_ratio_maxnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter categories whose Top-10 to Top-100 sales ratio is less than or equal to this value; higher means stronger product concentration.0
top10_product_sale_count_share_ratio_minnumberNoOptional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter categories whose Top-10 to Top-100 sales ratio is greater than or equal to this value; higher means stronger product concentration.0
semi_managed_shop_cumulative_sale_count_maxintegerNoOptional. If specified, filters categories whose Top-100 semi-managed shop cumulative sales volume is less than or equal to this value.0
semi_managed_shop_cumulative_sale_count_minintegerNoOptional. If specified, filters categories whose Top-100 semi-managed shop cumulative sales volume is greater than or equal to this value.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_temu_category_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "node_id": "7324",
    "page": 1,
    "site": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "avg_price": 7.91,
      "avg_review_count": 127,
      "avg_star": 4.66,
      "brand_count": 38,
      "monthly_sale_amount": 580659.28,
      "name": "Bathroom Furniture"
    }
  ],
  "doc": {
    "avg_price": "Average selling price of Top-100 products (in USD / the site's local currency, main currency unit; not cents).",
    "avg_review_count": "Average review count of Top-100 products.",
    "avg_star": "Average star rating of Top-100 products.",
    "brand_count": "Number of unique brands in Top-100 products.",
    "monthly_sale_amount": "Monthly sales amount of the product (in USD / the site's local currency, main currency unit; not cents).",
    "name": "Temu category display name."
  }
}

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