Amazon weekly search-term ranking
get_brand_search_termsAmazon's own weekly Brand Analytics search-term ranking for one marketplace on the connected seller account: which customer search terms rank where, the ASINs shoppers clicked on each, and how each term moved against the previous week. Rank 1 is the most-searched term, so a smaller rank is better. Requires Brand Registry; an unenrolled seller gets a named refusal rather than an estimate. Requires a marketplace id from list_my_marketplaces.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"marketplace_id": "<marketplace_id>"
},
"name": "get_brand_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 50). | |
| account | No | Seller id of the client account (from list_my_accounts). Only needed with several accounts. | |
| search_term | No | Optional: only terms containing this text. | |
| marketplace_id | Yes | Required marketplace id (from list_my_marketplaces). |