Amazon Product Search

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

Productivity
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.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.

ParameterTypeRequiredDescriptionDefault
asinstringNoQuery similar products based on ASIN (Note: this does NOT query only this ASIN. Call product_detail if you need this single product). Example: B0CVM8TXHP""
pageintegerNoPagination query, 20 items per page, default value 1 (pagination starts at 1, not 0).1
brandstringNoSearch hot-selling products by brand. Example: Anker""
keywordstringNoSearch hot-selling products by ABA keywords (ABA keywords only for now). Example: Power Bank""
node_idstringNoQuery based on category (not limited to subcategories). Example: 3743561""
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Allowed: US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA.Unknow
seller_idstringNoSearch hot-selling products by seller SellerId. Example: A294P4X9EWVXLJ""
seller_namestringNoSearch hot-selling products by seller name. Example: AnkerDirect""
shipping_typestringNoFilter products by fulfillment method. Example: FBA""
attribute_namestringNoSearch products containing specified terms in product title or attributes (matches products with target words in title or product attributes). Example: 10000mAh""
star_range_maxnumberNoMaximum star rating filter. Example: 4.80
star_range_minnumberNoMinimum star rating filter. Example: 4.00
price_range_maxnumberNoMaximum selling price filter (val <= set value). Example: 50.000
price_range_minnumberNoMinimum selling price filter (val >= set value). Example: 20.000
peak_selling_seasonstringNoFilter 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_maxstringNoUpper bound of product launch date. Date format: yyyy-MM-dd. Example: 2026-01-01""
online_date_range_minstringNoLower bound of product launch date. Date format: yyyy-MM-dd. Example: 2025-01-01""
category_rank_range_maxintegerNoMaximum main category rank filter (actual rank, rank #100 = value 100). Example: 1000
category_rank_range_minintegerNoMinimum main category rank filter (actual rank, rank #1 = value 1). Example: 10
comment_count_range_maxintegerNoMaximum review count filter. Example: 5000
comment_count_range_minintegerNoMinimum review count filter. Example: 500
variation_count_range_maxintegerNoMaximum variant count filter. Example: 100
variation_count_range_minintegerNoMinimum variant count filter. Example: 10
month_sale_volume_range_maxintegerNoMaximum monthly sales volume filter (val <= set value). Example: 10000
month_sale_volume_range_minintegerNoMinimum monthly sales volume filter (val >= set value). Example: 5000
sub_category_rank_range_maxintegerNoMaximum subcategory rank filter (actual rank, rank #100 = value 100). Example: 1000
sub_category_rank_range_minintegerNoMinimum subcategory rank filter (actual rank, rank #1 = value 1). Example: 10

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