Impression share by search or campaign
get_impression_shareGet the account's share of the ad impressions. level "searches" (default): each search's impression share (in %) and the advertiser's rank among every advertiser on it (1 = the most impressions), per marketplace and ad type, with is_brand_search (the search holds a term of the advertiser's "never negate" keyword list, its brand). level "campaigns": each campaign's top-of-search impression share (join campaign_id with list_campaigns for names). Amazon gives a share over a whole window, never per day: window is one of last_30_days, previous_30_days, last_90_days, last_365_days, all_time (all ending yesterday; campaigns: last_30_days, previous_30_days). Compare last_30_days with previous_30_days to see a share drop. A search with marketplace null was seen on several marketplaces Amazon does not name: its values are in marketplace_values. Answers "do I own my brand searches?", "who outranks me on my main keyword?" or "which campaigns rarely reach the top of search?". If meta.status is "preparing", Amazon is preparing the window: call again after meta.retry_after_seconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_impression_share"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort field, defaults to "impressions". Campaigns: impressions or impression_share only. | |
| level | No | "searches" (default) or "campaigns". | |
| limit | No | Items per page, 1 to 1000. Defaults to 100. | |
| order | No | "desc" (default) or "asc". A row without the value always comes last. | |
| cursor | No | The `next_cursor` of the previous page, to read the next one. Treat it as opaque. | |
| window | No | The days covered, defaults to "last_30_days". | |
| contains | No | level "searches": keep the searches containing this text. | |
| timezone | No | IANA time zone deciding which day "today" is for `range`, e.g. "Europe/Paris". Defaults to UTC. | |
| brand_only | No | level "searches": true keeps the brand searches only. | |
| ad_products | No | Keep only these ad types: SPONSORED_BRANDS, SPONSORED_PRODUCTS. Absent: both. | |
| marketplaces | No | Keep only these marketplaces, by country code: US, CA, MX, BR, UK, DE, FR, ES, IT, NL, SE, PL, BE, TR, AE, SA, EG, IN, ZA, JP, AU, SG. Absent: every marketplace. |