Amazon Product Search
Find Amazon products for product research and competitor benchmarking by combining marketplace, similar-product ASIN, category, brand, seller, ABA keyword, title or attribute terms, peak-season months, fulfillment method, and ranges for price, monthly sales volume, launch date, star rating, review count, variation count, and main or subcategory rank. ASIN searches find similar products, not details for that exact ASIN; the keyword filter supports ABA keywords only. Results are paginated with 20 items per page, starting at page 1. Enter launch dates as yyyy-MM-dd and separate peak-season months with commas. Rank filters use actual rank numbers. Returned product fields are not defined by a supplied output schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
Each call has a fixed charge of 1.05 credits, billed per call rather than by the number of products returned.
Each pagination request is billed as a separate call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
asin | string | No | Query similar products based on ASIN (Note: this does NOT query only this ASIN. Call product_detail if you need this single product). Example: B0CVM8TXHP | "" |
page | integer | No | Pagination query, 20 items per page, default value 1 (pagination starts at 1, not 0). | 1 |
brand | string | No | Search hot-selling products by brand. Example: Anker | "" |
keyword | string | No | Search hot-selling products by ABA keywords (ABA keywords only for now). Example: Power Bank | "" |
node_id | string | No | Query based on category (not limited to subcategories). Example: 3743561 | "" |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. Allowed: US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA. | Unknow |
seller_id | string | No | Search hot-selling products by seller SellerId. Example: A294P4X9EWVXLJ | "" |
seller_name | string | No | Search hot-selling products by seller name. Example: AnkerDirect | "" |
shipping_type | string | No | Filter products by fulfillment method. Example: FBA | "" |
attribute_name | string | No | Search products containing specified terms in product title or attributes (matches products with target words in title or product attributes). Example: 10000mAh | "" |
star_range_max | number | No | Maximum star rating filter. Example: 4.8 | 0 |
star_range_min | number | No | Minimum star rating filter. Example: 4.0 | 0 |
price_range_max | number | No | Maximum selling price filter (val <= set value). Example: 50.00 | 0 |
price_range_min | number | No | Minimum selling price filter (val >= set value). Example: 20.00 | 0 |
peak_selling_season | string | No | Filter seasonal products, only return products whose peak selling season includes the specified months. Separate multiple months with commas. Example: 2,3,4 | "" |
online_date_range_max | string | No | Upper bound of product launch date. Date format: yyyy-MM-dd. Example: 2026-01-01 | "" |
online_date_range_min | string | No | Lower bound of product launch date. Date format: yyyy-MM-dd. Example: 2025-01-01 | "" |
category_rank_range_max | integer | No | Maximum main category rank filter (actual rank, rank #100 = value 100). Example: 100 | 0 |
category_rank_range_min | integer | No | Minimum main category rank filter (actual rank, rank #1 = value 1). Example: 1 | 0 |
comment_count_range_max | integer | No | Maximum review count filter. Example: 500 | 0 |
comment_count_range_min | integer | No | Minimum review count filter. Example: 50 | 0 |
variation_count_range_max | integer | No | Maximum variant count filter. Example: 10 | 0 |
variation_count_range_min | integer | No | Minimum variant count filter. Example: 1 | 0 |
month_sale_volume_range_max | integer | No | Maximum monthly sales volume filter (val <= set value). Example: 1000 | 0 |
month_sale_volume_range_min | integer | No | Minimum monthly sales volume filter (val >= set value). Example: 500 | 0 |
sub_category_rank_range_max | integer | No | Maximum subcategory rank filter (actual rank, rank #100 = value 100). Example: 100 | 0 |
sub_category_rank_range_min | integer | No | Minimum subcategory rank filter (actual rank, rank #1 = value 1). Example: 1 | 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_product_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"comment_count_range_max": 300,
"month_sale_volume_range_min": 60,
"node_id": "13289351",
"online_date_range_min": "2026-05-01",
"page": 1,
"price_range_min": 35,
"variation_count_range_max": 2
}
}'{
"data": [
{
"a_plus": false,
"asin": "B0H7WYR5ZR",
"brand": "Pnknose",
"buybox_seller": "NYCX-US",
"category": [
"Sports & Outdoors"
],
"title": "Pilates Board-Pilates Reformer Set 6 in 1 Multifunctional Abdominal Pilates Board for Home Workout Equipment, Foldable Pilates Portable Reformer Machine, Ab Board Trainer for Women"
}
],
"doc": {
"a_plus": "Whether A+ content page exists.",
"asin": "Product ASIN.",
"brand": "Brand name.",
"buybox_seller": "Name of buy box owner.",
"data": "Array of product items. Each item contains the following fields:",
"title": "Product title."
},
"page": 1,
"page_count": 1
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

