Amazon Category Search From Product Name
Find Amazon sub-category markets related to a product category name, such as air fryer or phone power bank, with results sorted by sales volume from highest to lowest. A product category name is required. Optional filters include marketplace, average price in local currency, rating, ratings count, monthly sales volume, peak-season month, and sales shares for new products, Amazon-owned products, and leading products. Sales-share inputs use percentages from 0 to 100. Results are paginated, starting at page 1 with 20 records per page. This is a sub-category market search, not an individual product search; specific output fields are not defined by the provider.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | The page index of the query result. Defaults to page 1. Each page returns 20 records. | 1 |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
price_max | number | No | Optional: filter sub-category markets whose average price (in local currency) is less than or equal to this value. | -9999 |
price_min | number | No | Optional: filter sub-category markets whose average price (in local currency) is greater than or equal to this value. | -9999 |
ratings_max | number | No | Optional: filter sub-category markets whose rating is less than or equal to this value. | -9999 |
ratings_min | number | No | Optional: filter sub-category markets whose rating is greater than or equal to this value. | -9999 |
product_name | string | Yes | Required: the product category name to search (e.g. air fryer, phone power bank). | — |
ratings_count_max | integer | No | Optional: filter sub-category markets whose ratings count is less than or equal to this value. | -9999 |
ratings_count_min | integer | No | Optional: filter sub-category markets whose ratings count is greater than or equal to this value. | -9999 |
month_sales_volume_max | integer | No | Optional: filter sub-category markets whose monthly sales volume is less than or equal to this value. | -9999 |
month_sales_volume_min | integer | No | Optional: filter sub-category markets whose monthly sales volume is greater than or equal to this value. | -9999 |
seasonal_popular_product | enum (Both | January | February | March | April | May | June | July | August | September | October | November | December) | No | Optional: filter sub-categories whose peak season is the specified month. Allowed values: Both, January, February, March, April, May, June, July, August, September, October, November, December; defaults to Both. | Both |
newproduct_sales_share_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose new products launched within 3 months account for a share of Top-100 product sales less than or equal to this value. | -9999 |
newproduct_sales_share_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose new products launched within 3 months account for a share of Top-100 product sales greater than or equal to this value. | -9999 |
amazon_owned_sales_share_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose Amazon-owned sales share among Top-100 products is less than or equal to this value. | -9999 |
amazon_owned_sales_share_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose Amazon-owned sales share (seller concentration) among Top-100 products is greater than or equal to this value. | -9999 |
top3_product_sales_share_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose Top-3 product sales share among Top-100 products is less than or equal to this value. | -9999 |
top3_product_sales_share_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose Top-3 product sales share (sales concentration) among Top-100 products is greater than or equal to this value. | -9999 |
top100_top400_sales_share_max | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose Top-100 product sales as a share of Top-400 product sales is less than or equal to this value. | -9999 |
top100_top400_sales_share_min | number | No | Optional: expressed as a percentage from 0 to 100 (e.g. 40 means 40%). Filter sub-category markets whose Top-100 product sales as a share of Top-400 product sales (the lower the value, the deeper the long tail) is greater than or equal to this value. | -9999 |
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_search_from_product_name' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"page": 1,
"product_name": "Coolers"
}
}'{
"data": [
{
"amazon_owned_sales_share": "11.39%",
"average_price": "16.880000",
"average_review_count": "5503.21",
"average_star_rating": "4.61",
"category_name": "Lunch Bags",
"china_seller_share": "86.206897%"
}
],
"doc": {
"amazon_owned_sales_share": "Monthly sales share of Amazon-owned within top-100.",
"average_price": "Average selling price of top-100 products (string, local currency).Value -1: no data for that period.",
"average_review_count": "Average review count of top-100 products.",
"average_star_rating": "Average star rating of top-100 products.",
"category_name": "Sub-category name.",
"china_seller_share": "Monthly sales share of Chinese sellers within top-100."
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

