These are the tools that are live. All of them read. The write tools, and more read tools, are listed with their status in Read and write.
| Tool | Access | What it answers | Ad types |
|---|---|---|---|
| list_accounts | read | The accounts and marketplaces you can read, and which days have data. | All |
| get_account_overview | read | Totals for a period, per ad type and per day. | All |
| get_campaigns | read | Performance per campaign. | SP · SB · SD |
| get_ad_groups | read | Performance per ad group. | SP · SB · SD |
| get_keywords | read | Performance per keyword and per target. | SP · SB · SD |
| get_search_terms | read | What shoppers actually searched for. | SP · SB |
| get_placements | read | Performance per placement. | SP · SB |
| get_products | read | Advertising performance per product. | SP · SD |
| get_ads | read | Performance per Sponsored Brands ad. | SB |
| get_purchased_products | read | What was bought after a click, when it was not the advertised product. | SP · SB · SD |
| get_matched_targets | read | Where Sponsored Display ads actually showed. | SD |
| get_invalid_traffic | read | Impressions and clicks Amazon discarded as invalid. | SP · SB · SD |
| get_product_history | read | Best-seller rank, price and availability of each product, day by day. | All |
| get_structure | read | The account as it is set up now. | SP · SB · SD |
A star marks a required parameter. Everything else has a default, so a tool can be called with no arguments at all. The parameters shared by most tools are explained in Parameters, and what comes back in Reading the answers.
All tools
list_accounts
ReadReturns every marketplace on your plan: account name, seller or vendor, country, store, currency, and the first and last day with performance data. Call it first: the other tools need a period inside those days.
No parameters.
Ask
Which Amazon accounts can you see?
The call your AI makes
{}get_account_overview
ReadImpressions, clicks, cost, orders, sales, units, ACOS and ROAS for a period: in total, per ad type (Sponsored Products, Brands, Display) and per day.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
Ask
How did my ads do last week?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17"
}get_campaigns
ReadSP · SB · SDOne row per campaign for a period, with the campaign name and state. For budgets, bidding strategy and bid adjustments per placement, use `get_structure`.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Which 10 campaigns spent the most last week, and what was their ACOS?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "cost",
"limit": 10
}get_ad_groups
ReadSP · SB · SDOne row per ad group for a period, with the names of the ad group and its campaign.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Show the ad groups of campaign 123456789012345, best sales first.
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"campaign_id": "123456789012345",
"sort_by": "sales"
}get_keywords
ReadSP · SB · SDOne row per keyword, product target or automatic target for a period, with the keyword text or the targeting expression, the match type and the current bid.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Which keywords have an ACOS above 50%?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "acos",
"limit": 50
}get_search_terms
ReadSP · SBOne row per search term (or product page the ad showed on) and the keyword or target that caught it. Use it to find wasted spend and new keywords. When the term is a product, the row carries that product's title and image.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Which search terms cost money last week without a single sale?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "cost",
"limit": 100
}get_placements
ReadSP · SBOne row per campaign and placement: top of search, product pages, rest of search, off Amazon.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Is top of search worth its price in my biggest campaign?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"campaign_id": "123456789012345"
}get_products
ReadSP · SDOne row per advertised product (ASIN), added up over all campaigns, with the product's title, image, brand, category, price and availability.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Which products sold the most through ads last week?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "sales",
"limit": 20
}get_ads
ReadSBOne row per Sponsored Brands ad, with the ad's name, state, creative (headline, images, products) and landing page next to the figures.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
Which of my Sponsored Brands ads has the best ACOS this week?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "acos"
}get_purchased_products
ReadSP · SB · SDOne row per advertised product and purchased product, with orders, sales and units and the details of both products. Use it to see which products sell together. Sponsored Brands rows have no advertised product. The figures use the same attribution window as the other tools.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| sort_by | sales | orders | units | Highest first. Default: sales. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose advertised or purchased product (ASIN or title) contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
When people click my ads, which other products of mine do they end up buying?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "orders",
"limit": 20
}get_matched_targets
ReadSDOne row per Display target and the product page it matched, with that product's title and image next to the figures. Use it to see which product pages a category or audience target reaches.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| sort_by | cost | sales | clicks | impressions | orders | acos | roas | Highest first. Default: cost. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
| search | string | Only rows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains this text. |
| campaign_id | string | Only rows of this campaign. |
Ask
On which product pages did my Display ads show last week, and which of them sold?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"sort_by": "sales"
}get_invalid_traffic
ReadSP · SB · SDOne row per campaign with the gross figures, the invalid ones Amazon removed and did not charge for, and the invalid share in percent. Amazon reports this per campaign name, so there is no campaign id. Highest number of invalid clicks first.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 6 days before date_to, so the period is 7 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: yesterday. |
| ad_type | SP | SB | SD | Sponsored Products (default), Sponsored Brands or Sponsored Display. |
| search | string | Only campaigns whose name contains this text. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
Ask
Which campaigns had the most invalid clicks this week?
The call your AI makes
{
"date_from": "2026-11-11",
"date_to": "2026-11-17",
"ad_type": "SP"
}get_product_history
ReadOne row per product with its rank in its category now, at the start of the period, the best and worst in between, and a `history` list with one entry per day. Amazon only reports today's values, so the history starts on the day the marketplace was connected (`history_starts` in the answer). Lowest rank first.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| date_from | date | First day, as YYYY-MM-DD. Default: 29 days before date_to, so the period is 30 days. |
| date_to | date | Last day, as YYYY-MM-DD. Default: today. |
| search | string | Only products whose ASIN, title or category contains this text. |
| limit | integer | Rows to return. Default 50, at most 500. |
| offset | integer | Rows to skip, for the next page. |
Ask
Which of my products lost the most rank in their category this month?
The call your AI makes
{
"date_from": "2026-11-01",
"date_to": "2026-11-19"
}get_structure
ReadSP · SB · SDNo performance figures: the items themselves, with the complete record Amazon holds for each. Campaigns (budget, state, bidding strategy, bid adjustments per placement, targeting type, dates), ad groups, keywords, targets, negatives, product ads, ads and portfolios. Paused and archived items are included.
| Parameter | Type | What it does |
|---|---|---|
| marketplace_id | string | Which marketplace, from list_accounts. Leave it out when your plan has only one. |
| type* | campaign | ad_group | keyword | target | negatives | product_ad | ad | portfolio | What to list. negatives lists negative keywords and negative targets, at ad group and campaign level. |
| ad_type | SP | SB | SD | Leave out for all ad types. |
| state | ENABLED | PAUSED | ARCHIVED | Leave out for all states. |
| search | string | Only items whose name, keyword, ASIN, SKU or product title contains this text. |
| campaign_id | string | Only items of this campaign. |
| limit | integer | Rows to return. Default 100, at most 500. |
| offset | integer | Rows to skip, for the next page. |
Ask
Which campaigns have a bid adjustment for top of search?
The call your AI makes
{
"type": "campaign",
"ad_type": "SP",
"state": "ENABLED"
}