Amazon Product Search From History

1.05 credits/call
ae_amazon_product_search_from_history

Search Amazon product snapshots for a selected historical month to support product discovery, competitor research, and seasonal analysis. Set the marketplace and search_time (yyyy-MM), then narrow the search by brand, seller, category, ABA keyword, title or attribute terms, fulfillment method, seasonal months, or ranges for price, rating, reviews, variants, monthly sales, category rank, and launch date. An ASIN searches for similar products rather than retrieving only that ASIN. Launch dates use yyyy-MM-dd; seasonal months are comma-separated numbers. The provider documents history beginning at January 2024 with up to approximately two years of lookback; month availability is not guaranteed. Results are paginated with 20 products per page, starting at page 1. Each query targets one month; comparing months requires separate queries. Specific returned fields are not defined by a provider output schema.

Productivity
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.05 credits/call

1.05 credits/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). 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""
search_timestringNoHistorical month for snapshot lookup, format yyyy-MM. Max 2 years retrospective starting at 2024-01. Example:2026-08""
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. 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, multiple months separated by comma. 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). Example:1000
category_rank_range_minintegerNoMinimum main category rank filter (actual rank). 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). Example:1000
sub_category_rank_range_minintegerNoMinimum subcategory rank filter (actual rank). 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_from_history' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "amz_site": "US",
    "brand": "Originsure",
    "page": 1,
    "search_time": "2025-11"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "a_plus": true,
      "asin": "B0F9MVGJQL",
      "brand": "Originsure",
      "buybox_seller": "Originsure Direct",
      "category": [
        "Patio, Lawn & Garden"
      ],
      "title": "48“ L Collapsible Wagon Cart Foldable, 560lbs Weight Capacity 300L Heavy Duty Folding Beach Wagons with Big All-Terrain Wheels, Utility Carts for Groceries, Shopping, Camping, Sports-red"
    }
  ],
  "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.