Amazon Category Search From Product Name

1 credits/call
ae_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.

Productivity
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/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
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Unknow
price_maxnumberNoOptional: filter sub-category markets whose average price (in local currency) is less than or equal to this value.-9999
price_minnumberNoOptional: filter sub-category markets whose average price (in local currency) is greater than or equal to this value.-9999
ratings_maxnumberNoOptional: filter sub-category markets whose rating is less than or equal to this value.-9999
ratings_minnumberNoOptional: filter sub-category markets whose rating is greater than or equal to this value.-9999
product_namestringYesRequired: the product category name to search (e.g. air fryer, phone power bank).—
ratings_count_maxintegerNoOptional: filter sub-category markets whose ratings count is less than or equal to this value.-9999
ratings_count_minintegerNoOptional: filter sub-category markets whose ratings count is greater than or equal to this value.-9999
month_sales_volume_maxintegerNoOptional: filter sub-category markets whose monthly sales volume is less than or equal to this value.-9999
month_sales_volume_minintegerNoOptional: filter sub-category markets whose monthly sales volume is greater than or equal to this value.-9999
seasonal_popular_productenum (Both | January | February | March | April | May | June | July | August | September | October | November | December)NoOptional: 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_maxnumberNoOptional: 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_minnumberNoOptional: 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_maxnumberNoOptional: 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_minnumberNoOptional: 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_maxnumberNoOptional: 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_minnumberNoOptional: 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_maxnumberNoOptional: 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_minnumberNoOptional: 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.

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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