Amazon Category Low Price Search
Query Amazon low-price market category statistics for category research and screening, with at most 20 category records per call. Optionally restrict the scope to a category and its subcategories using node_id, and paginate with page starting at 1. The marketplace input accepts US or Unknow and defaults to Unknow. Optional minimum and maximum filters cover overall category monthly sales volume and amount; low-price product count and monthly sales volume and amount; average price, star rating, ratings count, online days, volume and weight; Amazon-owned and third-party seller product count ratios; and three-month new-product count and sales ratios. Minimum and maximum bounds are inclusive. Monetary filters use the smallest local currency unit; star ratings use 0.1-star units, volume uses 0.01 cubic inch, and weight uses 0.01 pound. Ratios are integer percentages from 0 to 100. This query concerns category statistics rather than individual product details. The provider has not specified the output fields or an exact low-price threshold.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
Each call is charged 1.05 AE credits.
Fetching another page requires a separate call, charged at the same fixed rate.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Page index for pagination, 20 records per page. Defaults to page 1. Page starts at 1, not 0. | 1 |
node_id | string | No | Optional: category NodeID, which restricts the query scope to the specified category and its sub-categories. | "" |
amz_site | enum (Unknow | US) | No | Amazon marketplace site. | Unknow |
average_star_max | integer | No | Optional: filter categories whose average star rating is less than or equal to this value; unit is 0.1 star, e.g. 46 means 4.6 stars. | 0 |
average_star_min | integer | No | Optional: filter categories whose average star rating is greater than or equal to this value; unit is 0.1 star, e.g. 46 means 4.6 stars. | 0 |
average_price_max | number | No | Optional: filter categories whose average price is less than or equal to this value, in the smallest unit of the local currency. | 0 |
average_price_min | number | No | Optional: filter categories whose average price is greater than or equal to this value, in the smallest unit of the local currency. | 0 |
average_volume_max | integer | No | Optional: filter categories whose average volume is less than or equal to this value; unit is 0.01 cubic inch, e.g. 3339 means 33.39. | 0 |
average_volume_min | integer | No | Optional: filter categories whose average volume is greater than or equal to this value; unit is 0.01 cubic inch, e.g. 3339 means 33.39. | 0 |
average_weight_max | integer | No | Optional: filter categories whose average weight is less than or equal to this value; unit is 0.01 pound, e.g. 44 means 0.44 pound. | 0 |
average_weight_min | integer | No | Optional: filter categories whose average weight is greater than or equal to this value; unit is 0.01 pound, e.g. 44 means 0.44 pound. | 0 |
average_online_days_max | integer | No | Optional: filter categories whose average online days is less than or equal to this value. | 0 |
average_online_days_min | integer | No | Optional: filter categories whose average online days is greater than or equal to this value. | 0 |
average_ratings_count_max | integer | No | Optional: filter categories whose average ratings count is less than or equal to this value. | 0 |
average_ratings_count_min | integer | No | Optional: filter categories whose average ratings count is greater than or equal to this value. | 0 |
amazon_owned_product_ratio_max | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose Amazon-owned product count ratio is less than or equal to this value. | 0 |
amazon_owned_product_ratio_min | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose Amazon-owned product count ratio is greater than or equal to this value. | 0 |
category_monthly_sale_count_max | integer | No | Optional: filter categories whose overall monthly sales volume is less than or equal to this value. | 0 |
category_monthly_sale_count_min | integer | No | Optional: filter categories whose overall monthly sales volume is greater than or equal to this value. | 0 |
category_monthly_sale_amount_max | number | No | Optional: filter categories whose overall monthly sales amount is less than or equal to this value, in the smallest unit of the local currency. | 0 |
category_monthly_sale_amount_min | number | No | Optional: filter categories whose overall monthly sales amount is greater than or equal to this value, in the smallest unit of the local currency. | 0 |
three_month_new_product_ratio_max | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose new product count ratio within 3 months is less than or equal to this value. | 0 |
three_month_new_product_ratio_min | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose new product count ratio within 3 months is greater than or equal to this value. | 0 |
low_price_category_product_count_max | integer | No | Optional: filter categories whose low-price product count is less than or equal to this value. | 0 |
low_price_category_product_count_min | integer | No | Optional: filter categories whose low-price product count is greater than or equal to this value. | 0 |
third_party_seller_product_ratio_max | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose third-party seller product count ratio is less than or equal to this value. | 0 |
third_party_seller_product_ratio_min | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose third-party seller product count ratio is greater than or equal to this value. | 0 |
three_month_new_product_sale_ratio_max | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose new product sales ratio within 3 months is less than or equal to this value. | 0 |
three_month_new_product_sale_ratio_min | integer | No | Optional: an integer from 0 to 100 representing a percentage (e.g. 40 means 40%), decimals are not supported. Filter low-price categories whose new product sales ratio within 3 months is greater than or equal to this value. | 0 |
low_price_category_monthly_sale_count_max | integer | No | Optional: filter categories whose low-price monthly sales volume is less than or equal to this value. | 0 |
low_price_category_monthly_sale_count_min | integer | No | Optional: filter categories whose low-price monthly sales volume is greater than or equal to this value. | 0 |
low_price_category_monthly_sale_amount_max | number | No | Optional: filter categories whose low-price monthly sales amount is less than or equal to this value, in the smallest unit of the local currency. | 0 |
low_price_category_monthly_sale_amount_min | number | No | Optional: filter categories whose low-price monthly sales amount is greater than or equal to this value, in the smallest unit of the local currency. | 0 |
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_amazon_category_low_price_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"page": 1
}
}'{
"data": [
{
"average_online_days": 340,
"average_price": 5.09,
"average_ratings_count": 10,
"average_star": 4.13,
"average_volume": 13.26,
"average_weight": 0.09
}
],
"doc": {
"average_online_days": "Average listing online days.",
"average_price": "Average selling price. (USD).Value -1: no data for that period.",
"average_ratings_count": "Average review count.",
"average_star": "Average star rating (0~5). (Actual star rating)",
"average_volume": "Average volume (cubic inch).",
"average_weight": "Average weight (lb)."
}
}This example shows part of the response. Copied content is valid JSON.

