Amazon Keyword List From History
Query Amazon's historical trending keyword list for a chosen date, sorted by weekly search volume. Provide a date in yyyy-MM-dd format, no earlier than 2025-03-04. You can optionally select an Amazon marketplace, choose a page, and set inclusive minimum and maximum bounds for weekly search-volume rank and monthly search volume. Pagination defaults to page 1, with 20 records per page. The provider has not specified a response schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
The query date, Amazon marketplace, page number and filters do not change the fixed charge per call. Querying another page requires a separate call with its own charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
date | string | Yes | The queried date, in yyyy-MM-dd format; the earliest supported date is 2025-03-04. | — |
page | integer | No | The page index of the query result. Defaults to page 1. Each page returns 20 records. | 1 |
rank_max | integer | No | Optional: filter keywords whose weekly search-volume rank is less than or equal to this value. | -9999 |
rank_min | integer | No | Optional: filter keywords whose weekly search-volume rank is greater than or equal to this value. | -9999 |
search_volume_max | integer | No | Optional: filter keywords whose monthly search volume is less than or equal to this value. | -9999 |
search_volume_min | integer | No | Optional: filter keywords whose monthly search volume is greater than or equal to this value. | -9999 |
keyword_support_site | enum (Unknow | US | GB | DE | FR | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
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_keyword_list_from_history' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"date": "2026-08-26",
"keyword_support_site": "US",
"page": 1
}
}'{
"data": [
{
"click_conversion_rate_90d": 50.26,
"click_volume_90d": 1566212,
"cpc_exact_bid": 1.46,
"cpc_exact_bid_range": [
1.10
],
"data_update_time": "20260901",
"keyword": "paper towels"
}
],
"doc": {
"click_conversion_rate_90d": "Click conversion rate in the last 90 days; currently only supported for the US site, shown as -1 when no value.",
"click_volume_90d": "Click volume in the last 90 days; currently only supported for the US site, shown as -1 when no value.",
"cpc_exact_bid": "Reference CPC exact bid value, in the site's local currency (e.g. USD for the US site), main currency unit, not cents.",
"cpc_exact_bid_range": "CPC exact bid range array, [min, max], in the site's local currency (e.g. USD for the US site), main currency unit, not cents.",
"data_update_time": "Data update time of this keyword, in yyyyMMdd format.",
"keyword": "The trending keyword text."
}
}This example shows part of the response. Copied content is valid JSON.

