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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
1.05 credits/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). 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 | "" |
search_time | string | No | Historical month for snapshot lookup, format yyyy-MM. Max 2 years retrospective starting at 2024-01. Example:2026-08 | "" |
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. 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, multiple months separated by comma. 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). Example:100 | 0 |
category_rank_range_min | integer | No | Minimum main category rank filter (actual rank). 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). Example:100 | 0 |
sub_category_rank_range_min | integer | No | Minimum subcategory rank filter (actual rank). 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_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"
}
}'{
"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.

