Amazon Keyword List From History

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

Productivity
1 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
datestringYesThe queried date, in yyyy-MM-dd format; the earliest supported date is 2025-03-04.—
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
rank_maxintegerNoOptional: filter keywords whose weekly search-volume rank is less than or equal to this value.-9999
rank_minintegerNoOptional: filter keywords whose weekly search-volume rank is greater than or equal to this value.-9999
search_volume_maxintegerNoOptional: filter keywords whose monthly search volume is less than or equal to this value.-9999
search_volume_minintegerNoOptional: filter keywords whose monthly search volume is greater than or equal to this value.-9999
keyword_support_siteenum (Unknow | US | GB | DE | FR | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site.Unknow

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