Amazon Keyword Trend
Review historical Amazon keyword trends for keyword research and advertising analysis, including search volume, search rank, and CPC bids. Provide a keyword; optionally select an Amazon marketplace and granularity. Use type=1 for weekly trends or type=2 for monthly trends (default). Weekly trends do not include CPC bids. The marketplace input defaults to "Unknow" when omitted.
Pricing
| Condition | Charge |
|---|---|
| (trend interval == 1) | 5.25 credits/call |
| ((trend interval == not provided) || (trend interval == 2)) | 2.62 credits/call |
Each call selects one fixed price based on the request. The table lists the verified tiers. (trend interval == 1): 5.25 credits/call. ((trend interval == not provided) || (trend interval == 2)): 2.62 credits/call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
type | integer | No | Granularity:1=Weekly(consume 10, no CPC trend);2=Monthly(consume5, default). Note:MCP type reversed vs API(API:1=month,2=week). MCP will auto map. | 2 |
keyword | string | Yes | The keyword to query. | — |
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_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "garden cart",
"keyword_support_site": "US",
"type": 2
}
}'{
"data": {
"cpc_trend": [
"202203"
],
"keyword": "garden cart",
"rank_trend": [
"202103"
],
"search_volume_trend": [
"202103"
]
},
"doc": {
"cpc_trend": "CPC trend 4-tuple array:[yyyyMM, cpc, minCpc, maxCpc...], unit:cent. Only return when type=2 monthly. (USD)",
"keyword": "ABA keyword.",
"rank_trend": "ABA search rank trend, flat array same format as search_volume_trend. Smaller number means better rank. (All elements are strings; smaller value represents higher ranking)",
"search_volume_trend": "Flat array [period,value,period,value...]. Monthly:yyyyMM; Weekly:yyyyMMdd week start date. Value is keyword search volume. (All elements are strings; flat key-value array by month, even index = month yyyyMM, odd index = search volume of that month)"
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

