Summary
A hosted MCP server that connects Claude, ChatGPT, and Cursor directly to Amazon Seller Central and Amazon Ads through OAuth. It exposes 141+ domain-scoped tools covering inventory, orders, catalog, rankings, finance, fulfillment, campaign performance, search terms, and TACOS metrics. Read operations are fast and factual. Write operations like updating prices, inventory quantities, or campaign budgets come with guardrails, previews, and audit logs. You get scoped API keys, read/write separation, and per-tenant data isolation. Setup requires an agentcentral account, Amazon OAuth connection, and adding the remote endpoint to your MCP client. Useful when you need agents to query seller metrics, inspect suppressed listings, analyze ad spend by ASIN, or execute guarded catalog and inventory changes without building your own SP-API integration.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
80 tools
get_campaign_performanceUse for Sponsored Products campaign-level ad performance over a date range: spend, sales, ACOS, ROAS, CTR, CPC, CVR. Grain: one row per campaign; recent ~3 days may be incomplete. Do not use for ad group, keyword, search-term, ASIN, or total organic+paid sales questions.9 params
Use for Sponsored Products campaign-level ad performance over a date range: spend, sales, ACOS, ROAS, CTR, CPC, CVR. Grain: one row per campaign; recent ~3 days may be incomplete. Do not use for ad group, keyword, search-term, ASIN, or total organic+paid sales questions.
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_campaign_snapshotsUse for Sponsored Products campaign settings snapshots from the campaign_snapshots sync. view='history' returns daily state, budget, bidding, portfolio, and placement bid adjustment rows. view='changes' returns deterministic setting changes between snapshots. This is not a liv...13 params
Use for Sponsored Products campaign settings snapshots from the campaign_snapshots sync. view='history' returns daily state, budget, bidding, portfolio, and placement bid adjustment rows. view='changes' returns deterministic setting changes between snapshots. This is not a liv...
Parameters* required
viewstringSnapshot view: history returns daily settings snapshots; changes returns setting deltas between snapshots.one of
history · changesdefault: historylimitintegerMax rows (1-1000, default 20)default: 20
statestringHistory view only. Filter by campaign stateone of
ENABLED · PAUSED · ARCHIVEDsort_bystringHistory view only. Column to sort by. Changes view sorts by snapshot_date.one of
snapshot_date · campaign_name · campaign_id · state · budget_amountend_datestringOptional. YYYY-MM-DD. Defaults to today.
profile_idstringFilter by ad account profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago.
campaign_idstringFilter by campaign ID
change_typesarrayChanges view only. Optional change types to include
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_adgroup_performanceUse to drill Sponsored Products performance from campaign to ad group: spend, sales, ACOS, ROAS, CTR, CPC, CVR. Grain: campaign + ad group; recent ~3 days may be incomplete. Do not use for bidded keyword/target or customer search-term analysis; use get_keyword_performance or g...10 params
Use to drill Sponsored Products performance from campaign to ad group: spend, sales, ACOS, ROAS, CTR, CPC, CVR. Grain: campaign + ad group; recent ~3 days may be incomplete. Do not use for bidded keyword/target or customer search-term analysis; use get_keyword_performance or g...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
ad_group_namestringFilter by ad group name (LIKE match)
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_placement_breakdownReturns Sponsored Products performance by ad placement (Top of Search, Detail Page, Other, Off Amazon) within campaigns; recent ~3 days may be incomplete. Use to compare placement-level spend, sales, ACOS, ROAS, CTR, and CVR. Does not include campaign totals, keyword performan...9 params
Returns Sponsored Products performance by ad placement (Top of Search, Detail Page, Other, Off Amazon) within campaigns; recent ~3 days may be incomplete. Use to compare placement-level spend, sales, ACOS, ROAS, CTR, and CVR. Does not include campaign totals, keyword performan...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_search_termsReturns customer search terms that triggered Sponsored Products and Sponsored Brands ads. Defaults to ad_product=auto, searching both SP and SB and returning ad_product on each row; set ad_product when you need one product only. Recent ~3 days may be incomplete. Does not inclu...16 params
Returns customer search terms that triggered Sponsored Products and Sponsored Brands ads. Defaults to ad_product=auto, searching both SP and SB and returning ad_product on each row; set ad_product when you need one product only. Recent ~3 days may be incomplete. Does not inclu...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
keywordstringFilter by matched keyword text (LIKE match, use % for wildcards).
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
ad_productstringSponsored ad product to search. Defaults to auto, which searches both Sponsored Products and Sponsored Brands search-term reports and returns ad_product on each row.one of
auto · SP · SBdefault: automatch_typestringFilter by match type or auto-targeting expression typeone of
BROAD · PHRASE · EXACT · TARGETING_EXPRESSION · TARGETING_EXPRESSION_PREDEFINED · AUTOprofile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
ad_group_idstringFilter by ad group ID.
campaign_idstringFilter by campaign ID. With ad_product=auto, searches matching SP and SB search-term reports.
search_termstringFilter by customer search term (LIKE match, use % for wildcards).
ad_group_namestringFilter by ad group name (LIKE match, use % for wildcards).
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_keyword_performanceReturns bidded Sponsored Products keyword/target performance. Grain: keyword/target + campaign/ad group with spend, sales, ACOS, ROAS, and impression share; recent ~3 days may be incomplete. Does not include actual customer search queries or market-wide query volume; use get_s...11 params
Returns bidded Sponsored Products keyword/target performance. Grain: keyword/target + campaign/ad group with spend, sales, ACOS, ROAS, and impression share; recent ~3 days may be incomplete. Does not include actual customer search queries or market-wide query volume; use get_s...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
keywordstringFilter by keyword (LIKE match)
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
keyword_typestringFilter by keyword typeone of
BROAD · PHRASE · EXACT · TARGETING_EXPRESSION · TARGETING_EXPRESSION_PREDEFINEDcampaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_product_performanceUse for Sponsored Products advertised ASIN/SKU performance by campaign/ad group: SP spend, clicks, sales, ACOS, ROAS, same-SKU sales; recent ~3 days may be incomplete. This is not total ad spend for an ASIN or brand: it excludes Sponsored Brands, DSP, and any campaign spend no...10 params
Use for Sponsored Products advertised ASIN/SKU performance by campaign/ad group: SP spend, clicks, sales, ACOS, ROAS, same-SKU sales; recent ~3 days may be incomplete. This is not total ad spend for an ASIN or brand: it excludes Sponsored Brands, DSP, and any campaign spend no...
Parameters* required
asinstringFilter by advertised ASIN (exact match)
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_purchased_productsReturns non-zero purchase attribution after ad clicks by default: advertised ASIN to purchased ASIN, campaign/ad group, sales, orders, and units; recent ~3 days may be incomplete. Set non_zero_only=false to include zero-attribution rows. Use for halo/cross-sell attribution pat...12 params
Returns non-zero purchase attribution after ad clicks by default: advertised ASIN to purchased ASIN, campaign/ad group, sales, orders, and units; recent ~3 days may be incomplete. Set non_zero_only=false to include zero-attribution rows. Use for halo/cross-sell attribution pat...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
sales · orders · units_sold · campaign_name · purchased_asin · advertised_asindefault: salesend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
non_zero_onlybooleanWhen true, omit rows where sales, orders, and units are all zero. Defaults to true.default: true
purchased_asinstringFilter by purchased ASIN (exact match)
advertised_asinstringFilter by advertised ASIN (exact match)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_search_query_performanceReturns Brand Analytics SQP weekly market search query volume, funnel metrics, and your ASIN's impression/click/cart/purchase share. Does not include ad spend/ACOS or the search terms that triggered ads; use get_search_terms/get_keyword_performance for ads search-term data.10 params
Returns Brand Analytics SQP weekly market search query volume, funnel metrics, and your ASIN's impression/click/cart/purchase share. Does not include ad spend/ACOS or the search terms that triggered ads; use get_search_terms/get_keyword_performance for ads search-term data.
Parameters* required
asinstringFilter by ASIN (exact match)
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
search_query_volume · search_query · market_cr · brand_cr · cr_delta · asin_impression_share_pctdefault: search_query_volumeend_datestringOptional. YYYY-MM-DD end date for week range. Defaults to today if omitted.
min_volumeintegerMinimum search query volume
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD start date for week range. Defaults to 30 days ago if omitted.
search_querystringFilter by search query (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_search_query_ad_coverageReturns SQP search query rows joined to observed ads search-term and keyword-target coverage.14 params
Returns SQP search query rows joined to observed ads search-term and keyword-target coverage.
Parameters* required
asinstringFilter by SQP ASIN (exact match)
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
search_query_volume · paid_spend · paid_clicks · paid_sales · paid_orders · matching_keyword_countdefault: search_query_volumeend_datestringOptional. YYYY-MM-DD end date for SQP week range. Defaults to today if omitted.
min_volumeintegerMinimum SQP search query volume
profile_idstringFilter ads evidence by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD start date for SQP week range. Defaults to 30 days ago if omitted.
ad_group_idstringFilter ads evidence by Sponsored Products ad group ID
campaign_idstringFilter ads evidence by Sponsored Products campaign ID
search_querystringFilter by SQP search query (LIKE match, use % for wildcards)
coverage_statestringFilter by deterministic paid coverage stateone of
exact_keyword_active · phrase_or_broad_keyword_active · auto_or_targeting_search_term_seen · search_term_seen_no_keyword_match · no_paid_coverage_observed · data_gapinclude_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_sales_and_trafficUse for historical total product performance from Business Reports (~72h delay): organic + PPC sales, sessions, page views, conversion, and Buy Box by ASIN/SKU. Do not use for current-day/yesterday account totals or ad-attributed campaign metrics; use get_sales_summary/get_tod...9 params
Use for historical total product performance from Business Reports (~72h delay): organic + PPC sales, sessions, page views, conversion, and Buy Box by ASIN/SKU. Do not use for current-day/yesterday account totals or ad-attributed campaign metrics; use get_sales_summary/get_tod...
Parameters* required
skustringFilter by SKU (exact match)
asinstringFilter by ASIN (exact match)
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
total_sales · units_ordered · sessions · page_views · avg_conversion_rate · avg_buy_box_pctdefault: total_salesend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_tacosUse for ASIN-level TACOS/PPC share by joining Sponsored Products + Sponsored Display ASIN-grain ad spend to Business Reports total sales (~72h delay). Grain: per ASIN. This is not total brand ad spend and excludes Sponsored Brands/DSP because those sources do not have determin...8 params
Use for ASIN-level TACOS/PPC share by joining Sponsored Products + Sponsored Display ASIN-grain ad spend to Business Reports total sales (~72h delay). Grain: per ASIN. This is not total brand ad spend and excludes Sponsored Brands/DSP because those sources do not have determin...
Parameters* required
asinstringFilter by ASIN (exact match)
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
total_sales · ad_spend · ad_sales · organic_sales · tacos · ppc_pctdefault: total_salesend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_sb_campaign_performanceUse for Sponsored Brands campaign performance, including new-to-brand, branded searches, video views, and detail page views. Grain: one SB campaign row; recent ~3 days may be incomplete. Do not use for Sponsored Products campaign metrics, ASIN-level TACOS, or product sales; us...9 params
Use for Sponsored Brands campaign performance, including new-to-brand, branded searches, video views, and detail page views. Grain: one SB campaign row; recent ~3 days may be incomplete. Do not use for Sponsored Products campaign metrics, ASIN-level TACOS, or product sales; us...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_sd_campaign_performanceUse for Sponsored Display campaign performance, including viewability, new-to-brand metrics, detail page views, spend, sales, and ACOS. Grain: one SD campaign row; recent ~3 days may be incomplete. Do not use for Sponsored Products/Sponsored Brands or total product sales; use...9 params
Use for Sponsored Display campaign performance, including viewability, new-to-brand metrics, detail page views, spend, sales, and ACOS. Grain: one SD campaign row; recent ~3 days may be incomplete. Do not use for Sponsored Products/Sponsored Brands or total product sales; use...
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_sponsored_ads_reportUse for retained Sponsored Products, Sponsored Brands, and Sponsored Display report views when you need one parameterized cross-product report surface. Especially useful for SB/SD ads, search terms, targeting, purchased products, and invalid traffic that are not exposed as nar...20 params
Use for retained Sponsored Products, Sponsored Brands, and Sponsored Display report views when you need one parameterized cross-product report surface. Especially useful for SB/SD ads, search terms, targeting, purchased products, and invalid traffic that are not exposed as nar...
Parameters* required
asinstringFilter by advertised, promoted, purchased, or targeting ASIN where the selected view supports an ASIN column.
ad_idstringFilter by ad/ad product-ad ID when the selected view has ad grain.
limitintegerMax rows (1-1000, default 20).default: 20
keywordstringFilter by keyword text (LIKE match) where the selected view includes keyword text.
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
ad_productstringSponsored ad product: SP (Sponsored Products), SB (Sponsored Brands), or SD (Sponsored Display).one of
SP · SB · SDprofile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
ad_group_idstringFilter by ad group ID when the selected view has ad-group grain.
campaign_idstringFilter by campaign ID.
report_viewstringRetained report view to query. Unsupported product/view combinations return metadata instead of guessing.one of
campaigns · ad_groups · ads · advertised_products · search_terms · targetingsearch_termstringFilter by customer search term (LIKE match) for search-term views.
target_querystringFilter targeting text/expression (LIKE match) for targeting views.
ad_group_namestringFilter by ad group name (LIKE match) when available.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
non_zero_onlybooleanWhen true, omit rows with zero or null spend, sales, orders, units, impressions, and clicks.default: false
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_dsp_performanceUse for Amazon DSP Reporting v3 performance at order, line item, and creative grain: spend, sales, ROAS, viewability, and video completion. Do not use for Sponsored Products/Brands/Display, search terms, or seller account sales; use the matching ads or sales tool.12 params
Use for Amazon DSP Reporting v3 performance at order, line item, and creative grain: spend, sales, ROAS, viewability, and video completion. Do not use for Sponsored Products/Brands/Display, search terms, or seller account sales; use the matching ads or sales tool.
Parameters* required
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
spend · sales · direct_sales · orders · units_sold · roasdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to yesterday.
min_spendnumberOnly include rows with at least this spend
order_namestringFilter by DSP order name (LIKE match, use % for wildcards)
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago.
creative_namestringFilter by creative name (LIKE match, use % for wildcards)
line_item_namestringFilter by DSP line item name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
dsp_advertiser_idstringFilter by DSP advertiser ID
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_dsp_advertisers_liveReturn Amazon-source DSP advertiser records accessible to an Ads profile. Use this to discover DSP advertiser IDs for the Amazon-Ads-AccountId header used by get_dsp_entities_live.5 params
Return Amazon-source DSP advertiser records accessible to an Ads profile. Use this to discover DSP advertiser IDs for the Amazon-Ads-AccountId header used by get_dsp_entities_live.
Parameters* required
limitintegerMaximum advertiser rows to return from list responses.default: 100
profile_idstringAmazon Ads profile ID used for the DSP advertiser lookup.
advertiser_idstringOptional DSP advertiser ID. When supplied, returns that advertiser record if Amazon grants access.
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_dsp_entities_liveList Amazon-source DSP campaigns, ad groups, or targets through documented DSP v1 campaign-management read endpoints. Requires an explicit Amazon-Ads-AccountId DSP advertiser ID and returns factual source fields only; no DSP writes are exposed.13 params
List Amazon-source DSP campaigns, ad groups, or targets through documented DSP v1 campaign-management read endpoints. Requires an explicit Amazon-Ads-AccountId DSP advertiser ID and returns factual source fields only; no DSP writes are exposed.
Parameters* required
statesarrayDSP targets only: optional Amazon DSP state filter values such as ENABLED. Campaign/ad-group state filters are not sent because Amazon does not document them for those list endpoints.
next_tokenstringAmazon pagination token from a previous DSP list response.
profile_idstringAmazon Ads profile ID associated with the DSP advertiser account.
target_idsarrayDSP targets only: filter targets by target ID. Target reads require target_ids or ad_group_ids because Amazon documents those as the bounded target-list filters.
entity_typestringDSP entity family to list: campaign, ad_group, or target.one of
campaign · ad_group · targetmax_resultsintegerMaximum rows to request from Amazon (1-100).default: 50
ad_group_idsarrayFilter DSP ad groups by ad group ID, or targets by ad group ID.
campaign_idsarrayFilter DSP campaigns by campaign ID, or ad groups by campaign ID. DSP target list docs do not expose a campaign-id filter.
target_typesarrayDSP targets only: optional target type filters such as AUDIENCE or LOCATION.
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_regionalbooleanDSP campaigns/ad groups only: request cross-region records when Amazon supports includeRegional.default: false
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
amazon_ads_account_idstringRequired Amazon-Ads-AccountId header value for DSP v1 campaign-management APIs. Amazon documents this as the Amazon DSP advertiser ID; discover it with get_dsp_advertisers_live.
get_store_performanceUse for Amazon Brand Store analytics by date, store, page, source, or tag: views, visits, orders, units, sales, dwell time, bounce rate, and new-to-store. Do not use for account sales totals, ASIN/SKU sales, or ad campaign performance; use sales or ads tools.17 params
Use for Amazon Brand Store analytics by date, store, page, source, or tag: views, visits, orders, units, sales, dwell time, bounce rate, and new-to-store. Do not use for account sales totals, ASIN/SKU sales, or ad campaign performance; use sales or ads tools.
Parameters* required
tagstringFilter by source tag name
limitintegerMax rows (1-1000, default 20)default: 20
sourcestringFilter by traffic source, such as ADS, ORGANIC, or OTHER
page_idstringFilter by Brand Store page ID
sort_bystringColumn to sort byone of
date · store_name · dimension_value · views · visits · visitorsdefault: viewsend_datestringOptional. YYYY-MM-DD. Defaults to yesterday.
dimensionstringBreakdown to return: date, store, page, source, or tagone of
date · store · page · source · tagdefault: datemin_salesnumberOnly include rows with at least this sales amount
min_viewsnumberOnly include rows with at least this many page views
page_namestringFilter by Brand Store page name (LIKE match, use % for wildcards)
profile_idstringFilter by ad account profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago.
store_namestringFilter by store name (LIKE match, use % for wildcards)
brand_entity_idstringFilter by Brand Store entity ID
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_portfolio_performanceReturns Sponsored Products performance rolled up by portfolio ID, joined from campaign metrics and latest portfolio assignment snapshot. Grain: one row per portfolio. For individual campaign/ad group/keyword metrics, use the matching drilldown tool.11 params
Returns Sponsored Products performance rolled up by portfolio ID, joined from campaign metrics and latest portfolio assignment snapshot. Grain: one row per portfolio. For individual campaign/ad group/keyword metrics, use the matching drilldown tool.
Parameters* required
limitintegerMax rows (1-1000, default 20).default: 20
sort_bystringColumn to sort byone of
spend · sales · acos · roas · ctr · cpcdefault: spendend_datestringOptional. YYYY-MM-DD. Defaults to today if omitted.
profile_idstringFilter by profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago if omitted.
portfolio_idstringFilter by portfolio ID. Use 'unassigned' for campaigns without a portfolio.
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_unassignedbooleanInclude campaigns that are not assigned to a portfolio.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
diagnose_performanceUse when sponsored ads performance changed and you need retained-report root-cause comparison between two periods. Defaults to Sponsored Products and can also diagnose Sponsored Brands or Sponsored Display. Compares product-appropriate campaign, ad, search-term, targeting, or...10 params
Use when sponsored ads performance changed and you need retained-report root-cause comparison between two periods. Defaults to Sponsored Products and can also diagnose Sponsored Brands or Sponsored Display. Compares product-appropriate campaign, ad, search-term, targeting, or...
Parameters* required
ad_productstringSponsored ad product to diagnose: SP, SB, or SD. Defaults to SP for backwards compatibility.one of
SP · SB · SDdefault: SPprofile_idstringFilter by profile ID
compare_endstringComparison period end date (YYYY-MM-DD)
current_endstringCurrent period end date (YYYY-MM-DD)
focus_metricstringMetric to focus root cause analysis onone of
spend · sales · acos · impressions · clicksdefault: acoscampaign_namestringFilter by campaign name (LIKE match)
compare_startstringComparison period start date (YYYY-MM-DD)
current_startstringCurrent period start date (YYYY-MM-DD)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_bid_recommendationsGet suggested bid amounts for keywords. Requires either ASINs for a new ad group context or both campaign_id and ad_group_id for an existing ad group. Returns Amazon's recommended bid with low and high range for each keyword.8 params
Get suggested bid amounts for keywords. Requires either ASINs for a new ad group context or both campaign_id and ad_group_id for an existing ad group. Returns Amazon's recommended bid with low and high range for each keyword.
Parameters* required
asinsarrayASINs for a new ad group context. Provide this or both campaign_id and ad_group_id.
keywordsarrayKeywords to get bid recommendations for
profile_idstringAd account profile ID
ad_group_idstringExisting ad group ID to use for bid recommendations. Requires campaign_id.
campaign_idstringExisting campaign ID to use for bid recommendations. Requires ad_group_id.
bidding_strategystringBidding strategy for new ad group recommendations. Ignored when campaign_id and ad_group_id are provided.one of
AUTO_FOR_SALES · LEGACY_FOR_SALES · MANUAL · RULE_BASEDinclude_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_budget_recommendationsReturns Amazon Ads budget recommendation API fields for campaigns, including suggested budgets and estimated missed impressions, clicks, and sales.4 params
Returns Amazon Ads budget recommendation API fields for campaigns, including suggested budgets and estimated missed impressions, clicks, and sales.
Parameters* required
profile_idstringAd account profile ID
campaign_idsarrayCampaign IDs to get budget recommendations for
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_budget_pacingUse for Sponsored Products budget usage/pacing snapshots: usage percent, used/remaining budget, and exhausted/at-risk labels by campaign. Do not use for performance efficiency, sales totals, or budget recommendations; use get_campaign_performance, sales tools, or get_budget_re...13 params
Use for Sponsored Products budget usage/pacing snapshots: usage percent, used/remaining budget, and exhausted/at-risk labels by campaign. Do not use for performance efficiency, sales totals, or budget recommendations; use get_campaign_performance, sales tools, or get_budget_re...
Parameters* required
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
snapshot_date · campaign_name · campaign_id · budget_usage_percent · budget_remaining_amount · usage_updated_atdefault: budget_usage_percentend_datestringOptional. YYYY-MM-DD. Defaults to today.
profile_idstringFilter by ad account profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 7 days ago.
campaign_idstringFilter by Sponsored Products campaign ID
latest_onlybooleanWhen true, return the latest snapshot per campaign in the selected date rangedefault: true
campaign_namestringFilter by campaign name (LIKE match, use % for wildcards)
at_risk_percentnumberThreshold used to label campaigns as at_riskdefault: 80
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
min_usage_percentnumberOnly return campaigns at or above this budget usage percentage
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_ad_eligibilityCheck product eligibility for selected ad types. Defaults to Sponsored Products, Brands, and Display, and can optionally include DSP. Returns overall status and any eligibility warnings or ineligibility reasons for each ASIN/SKU.5 params
Check product eligibility for selected ad types. Defaults to Sponsored Products, Brands, and Display, and can optionally include DSP. Returns overall status and any eligibility warnings or ineligibility reasons for each ASIN/SKU.
Parameters* required
asinsarrayASINs to check eligibility for
ad_typesarrayOptional ad types to check. Defaults to SP, SB, and SD.
profile_idstringAd account profile ID
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_brand_healthGet Amazon Ads Brand Metrics health by brand and category: awareness, consideration, sales, engaged-shopper rate, conversion rate, and new-to-brand rate versus category peers.11 params
Get Amazon Ads Brand Metrics health by brand and category: awareness, consideration, sales, engaged-shopper rate, conversion rate, and new-to-brand rate versus category peers.
Parameters* required
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
metrics_computation_date · brand_name · category_path · awareness_index · consideration_index · sales_indexdefault: metrics_computation_dateend_datestringOptional. YYYY-MM-DD. Defaults to today.
brand_namestringFilter by brand name (LIKE match, use % for wildcards)
profile_idstringFilter by ad account profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 90 days ago.
category_pathstringFilter by category path (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
category_tree_namestringFilter by category tree name
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_share_of_voiceGet Amazon Ads Brand Metrics share-of-voice signals by brand and category, including awareness, consideration, sales, branded searches, detail-page views, add-to-carts, and brand-customer counts versus category peers.12 params
Get Amazon Ads Brand Metrics share-of-voice signals by brand and category, including awareness, consideration, sales, branded searches, detail-page views, add-to-carts, and brand-customer counts versus category peers.
Parameters* required
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
metrics_computation_date · brand_name · category_path · awareness_index · consideration_index · sales_indexdefault: awareness_indexend_datestringOptional. YYYY-MM-DD. Defaults to today.
brand_namestringFilter by brand name (LIKE match, use % for wildcards)
profile_idstringFilter by ad account profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 90 days ago.
category_pathstringFilter by category path (LIKE match, use % for wildcards)
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
category_tree_namestringFilter by category tree name
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
min_awareness_indexnumberMinimum awareness index
get_attribution_performanceUse for Amazon Attribution tagged off-Amazon traffic, with publisher, campaign/ad group/creative, product, purchases, sales, brand halo, and new-to-brand metrics. Product fields product_asin, product_name, brand_name, and marketplace are populated for report_type=PRODUCTS; PER...16 params
Use for Amazon Attribution tagged off-Amazon traffic, with publisher, campaign/ad group/creative, product, purchases, sales, brand halo, and new-to-brand metrics. Product fields product_asin, product_name, brand_name, and marketplace are populated for report_type=PRODUCTS; PER...
Parameters* required
limitintegerMax rows (1-1000, default 20)default: 20
sort_bystringColumn to sort byone of
date · publisher · campaign_id · ad_group_id · creative_id · attributed_sales_14ddefault: attributed_sales_14dend_datestringOptional. YYYY-MM-DD. Defaults to yesterday.
min_salesnumberOnly include rows with at least this 14-day attributed sales value
publisherstringFilter by off-Amazon publisher (LIKE match, use % for wildcards)
profile_idstringFilter by ad account profile ID
sort_orderstringSort orderone of
asc · descdefault: descstart_datestringOptional. YYYY-MM-DD. Defaults to 30 days ago.
ad_group_idstringFilter by Attribution ad group ID
campaign_idstringFilter by Attribution campaign ID
creative_idstringFilter by Attribution creative ID
report_typestringAttribution report typeone of
PERFORMANCE · PRODUCTS · ALLdefault: PERFORMANCEproduct_asinstringFilter product-report rows by purchased ASIN
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
product_conversion_typestringFilter product-report rows by conversion type
get_audience_segmentsDiscover available Amazon Ads audience IDs for a profile from targetableEntities/list, with optional text and category-path search. The live endpoint's taxonomy is returned in category; type is often AUDIENCE, and Amazon may omit name, provider, status, and description.7 params
Discover available Amazon Ads audience IDs for a profile from targetableEntities/list, with optional text and category-path search. The live endpoint's taxonomy is returned in category; type is often AUDIENCE, and Amazon may omit name, provider, status, and description.
Parameters* required
querystringOptional free-text search for audience segment names, descriptions, types, or categories.
profile_idstringAd account profile ID
max_resultsintegerMaximum number of audience segments to return. Defaults to 25.default: 25
segment_typesarrayDeprecated legacy filter. segment_types is deprecated for get_audience_segments on targetableEntities/list. Use category_path_contains to filter Amazon's current category taxonomy.
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
category_path_containsstringOptional case-insensitive substring filter against Amazon's category path, for example 'Custom-built > Product'.
get_sponsored_ads_entities_liveList current Sponsored Products, Sponsored Brands, or Sponsored Display entity state directly from Amazon Ads API for verified read-only combinations. Returns Amazon-source fields with bounded pagination and diagnostics for unsupported product/entity pairs; agentcentral does n...20 params
List current Sponsored Products, Sponsored Brands, or Sponsored Display entity state directly from Amazon Ads API for verified read-only combinations. Returns Amazon-source fields with bounded pagination and diagnostics for unsupported product/entity pairs; agentcentral does n...
Parameters* required
idsarrayEntity IDs for the selected entity type.
asinsarraySponsored Products target ASIN filter where Amazon supports it.
scopestringSponsored Products negative entities only: restrict to ad-group-level or campaign-level records. Omit to query both.one of
ad_group · campaignstatesarrayEntity states to include. Product-specific unsupported state filters, including SD PROPOSED, return diagnostics without an API call.
ad_productstringSponsored ad product to query: SP, SB, or SD.one of
SP · SB · SDname_querystringCampaign/ad-group/ad name filter where Amazon supports it. SD name filters are exact-match per Amazon docs.
next_tokenstringAmazon pagination token for SP/SB list endpoints.
profile_idstringAd account profile ID
text_querystringSponsored Products keyword or negative keyword text filter.
entity_typestringEntity family to list. Supported combinations are returned in diagnostics for unsupported product/entity pairs.one of
campaign · ad_group · ad · product_ad · keyword · targetmatch_typesarraySponsored Products keyword or negative keyword match type filter.
max_resultsintegerMaximum rows to request from Amazon (1-100).default: 50
start_indexintegerSponsored Display offset pagination cursor. SD uses start_index/count instead of next_token.default: 0
ad_group_idsarrayRestrict to ad group IDs.
campaign_idsarrayRestrict to campaign IDs.
portfolio_idsarrayCampaign-level portfolio ID filter where Amazon supports it.
expression_typesarraySponsored Products target expression type filter.
include_raw_rowsbooleanSet false to return a compact row preview while keeping diagnostics.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
include_extended_databooleanRequest extended fields where Amazon documents them. For SB ads this is ignored because the list endpoint has no extended-data flag.default: true
get_sponsored_ads_targeting_optionsReturn Amazon-source Sponsored Products, Sponsored Brands, and Sponsored Display targeting option and bid-recommendation fields for documented read-only endpoints. Unsupported or ambiguous endpoint slices return diagnostics without an Amazon call; AMC is out of scope.39 params
Return Amazon-source Sponsored Products, Sponsored Brands, and Sponsored Display targeting option and bid-recommendation fields for documented read-only endpoints. Unsupported or ambiguous endpoint slices return diagnostics without an Amazon call; AMC is out of scope.
Parameters* required
asinsarrayASIN inputs for SP recommendations or convenience SD product payloads.
brandsarraySB products_count brand refinement IDs.
cursorstringSP product recommendation pagination cursor.
genresarraySB products_count genre refinement IDs.
localestringOptional Amazon Ads locale, such as en_US or de_DE.
tacticstringSD target_recommendations tactic.one of
T00020 · T00030default: T00030themedbooleanSP product recommendations only: request Amazon theme-grouped output when supported.default: false
themesvalueSD target_recommendations themes object from Amazon's schema.
keywordstringSP negative brand search keyword.
productsarraySD target/bid recommendation products array from Amazon's schema. Use request_body for full raw control.
cost_typestringSD bid_recommendations costType.one of
cpc · vcpmdefault: cpcad_productstringSponsored ad product to query: SP, SB, or SD.one of
SP · SB · SDage_rangesarraySB products_count age-range refinement IDs.
next_tokenstringSB category/refinement pagination token.
profile_idstringAd account profile ID.
ad_group_idstringSponsored Products keyword recommendations ad group ID.
campaign_idstringSponsored Products keyword recommendations campaign ID.
category_idstringCategory refinement ID for category_refinements or products_count.
max_resultsintegerMaximum Amazon-source options to request where supported.default: 50
option_typestringAmazon-source targeting or bid-option surface. Unsupported product/option pairs return diagnostics without an API call.one of
keyword_recommendations · product_recommendations · category_recommendations · category_tree · category_refinements · products_countprice_rangevalueSB products_count price range object from Amazon's schema, for example { min, max }.
type_filterarraySD target_recommendations typeFilter. Defaults to PRODUCT, CATEGORY, and AUDIENCE.
rating_rangevalueSB products_count rating range object from Amazon's schema, for example { min, max }.
request_bodyobjectAdvanced override: exact Amazon Ads request body for the selected endpoint. Use only when following Amazon's published schema.
category_typestringSD target_recommendations categoryType for category audiences.one of
views · purchasescreative_typestringSD bid_recommendations creativeType.one of
IMAGE · VIDEOlanding_pagesarraySB optimization_recommendations landingPages array from Amazon's schema.
supply_sourcestringSB category supply source. STREAMING_VIDEO is deprecated; agentcentral only exposes AMAZON.one of
AMAZONdefault: AMAZONbid_optimizationstringSD bid_recommendations bidOptimization.one of
reach · clicks · conversionsdefault: clicksinclude_ancestorbooleanSP category recommendations only: include ancestor categories when Amazon supports it.default: false
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
is_prime_shippingbooleanSB products_count Prime-shipping refinement.
targeting_clausesarraySD bid_recommendations targetingClauses array from Amazon's schema.
candidate_keywordsarrayOptional SP keyword candidates to include alongside Amazon keyword recommendations.
cost_control_metricstringSB optimization recommendation metric. Amazon currently supports COST_PER_CLICK.one of
COST_PER_CLICKdefault: COST_PER_CLICKinclude_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
location_expressionarraySD target_recommendations locationExpression from Amazon's schema.
include_only_root_categoriesbooleanSB category tree only: return only root categories.
parent_category_refinement_idstringSB category tree only: return children of this parent category refinement ID.
get_sp_entities_liveList current Sponsored Products live entity state directly from Amazon Ads API for campaigns, ad groups, product ads, keywords, targets, negative keywords, and negative targets. Use before write operations when warehouse snapshots may lag.16 params
List current Sponsored Products live entity state directly from Amazon Ads API for campaigns, ad groups, product ads, keywords, targets, negative keywords, and negative targets. Use before write operations when warehouse snapshots may lag.
Parameters* required
idsarrayEntity IDs for the selected entity_type
asinsarrayASIN filter for targets/negative targets where Amazon supports it
scopestringFor negative_keyword or negative_target, restrict to ad-group-level or campaign-level entities. Omit to query both where possible.one of
ad_group · campaignstatesarrayEntity states to include
name_querystringCampaign/ad-group name query
next_tokenstringAmazon pagination token from a prior response
profile_idstringAd account profile ID
text_querystringKeyword text or negative keyword text query
entity_typestringSponsored Products live entity family to listone of
campaign · ad_group · product_ad · keyword · target · negative_keywordmatch_typesarrayKeyword or negative keyword match type filter
max_resultsintegerMaximum rows to request from Amazon (1-250)default: 50
ad_group_idsarrayRestrict to ad group IDs
campaign_idsarrayRestrict to campaign IDs
expression_typesarrayTarget expressionType filter
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
get_sp_targeting_optionsReturn Amazon-source Sponsored Products targeting options and recommendation fields: keyword candidates, product target candidates, category recommendations/tree/refinements, and negative brand search/recommendations. Source-attributed read-only data; agentcentral does not dec...15 params
Return Amazon-source Sponsored Products targeting options and recommendation fields: keyword candidates, product target candidates, category recommendations/tree/refinements, and negative brand search/recommendations. Source-attributed read-only data; agentcentral does not dec...
Parameters* required
asinsarrayInput ASINs for product/category recommendations
cursorstringAmazon cursor for product recommendation pagination
localestringOptional Amazon Ads locale, such as en_US or de_DE
themedbooleanFor product recommendations, request Amazon theme-grouped output when supporteddefault: false
keywordstringBrand search keyword for negative_brand_search
profile_idstringAd account profile ID
ad_group_idstringAd group ID for keyword recommendations
campaign_idstringCampaign ID for keyword recommendations
category_idstringCategory ID for category_refinements
max_resultsintegerMaximum Amazon-source options to request where supporteddefault: 50
option_typestringAmazon-source targeting discovery surface to callone of
keyword_recommendations · product_recommendations · category_recommendations · category_tree · category_refinements · negative_brand_searchinclude_ancestorbooleanFor category recommendations, include ancestor categories when Amazon supports itdefault: false
include_raw_rowsbooleanFalse returns compact rows. Default true.default: true
candidate_keywordsarrayOptional keywords to rank alongside Amazon keyword recommendations
include_diagnosticsbooleanTrue adds empty/freshness diagnostics. Default false.default: false
create_sp_campaignsPreview or submit Sponsored Products campaign creation through /sp/campaigns. Defaults new campaigns to PAUSED unless state is explicitly ENABLED. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Products campaign creation through /sp/campaigns. Defaults new campaigns to PAUSED unless state is explicitly ENABLED. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
campaignsarrayprofile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
create_sp_ad_groupsPreview or submit Sponsored Products ad group creation through /sp/adGroups. Defaults to PAUSED. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Products ad group creation through /sp/adGroups. Defaults to PAUSED. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
ad_groupsarrayprofile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
create_sp_product_adsPreview or submit Sponsored Products product ad creation through /sp/productAds. Provide sku or asin. Defaults to PAUSED. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Products product ad creation through /sp/productAds. Provide sku or asin. Defaults to PAUSED. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
product_adsarrayidempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sp_ad_entitiesPreview or submit Sponsored Products ad group and product ad lifecycle updates. Supports reversible ENABLED/PAUSED state changes and irreversible archive operations. Max 100 per call. confirm=true requires idempotency_key; archive also requires archive_acknowledgement=true.9 params
Preview or submit Sponsored Products ad group and product ad lifecycle updates. Supports reversible ENABLED/PAUSED state changes and irreversible archive operations. Max 100 per call. confirm=true requires idempotency_key; archive also requires archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayoperationstringUse set_state for reversible ENABLED/PAUSED changes; archive is irreversible and requires archive_acknowledgement=true on submit.one of
set_state · archiveprofile_idstringAd account profile ID
entity_typestringSponsored Products entity family to update.one of
ad_group · product_adidempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when operation=archive and confirm=true.default: false
create_sp_targetsPreview or submit Sponsored Products targeting clause creation through /sp/targets for auto, ASIN, category, or Amazon expression predicates. Defaults to PAUSED. Max 100 per call. Bid bounds enforced per marketplace. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Products targeting clause creation through /sp/targets for auto, ASIN, category, or Amazon expression predicates. Defaults to PAUSED. Max 100 per call. Bid bounds enforced per marketplace. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
targetsarrayprofile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sp_target_statePreview or submit Sponsored Products target state updates through /sp/targets. Use archive_sp_targets for irreversible archives. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Products target state updates through /sp/targets. Use archive_sp_targets for irreversible archives. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sp_targetsPreview or submit irreversible Sponsored Products target archives through /sp/targets/delete. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Products target archives through /sp/targets/delete. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
target_idsarrayidempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because target archive is irreversible.default: false
create_sp_negative_targetsPreview or submit Sponsored Products negative ASIN/brand target creation through /sp/negativeTargets or /sp/campaignNegativeTargets. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Products negative ASIN/brand target creation through /sp/negativeTargets or /sp/campaignNegativeTargets. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
negative_targetsarrayupdate_sp_negative_keyword_statePreview or submit reversible Sponsored Products negative keyword state updates through /sp/negativeKeywords or /sp/campaignNegativeKeywords. Max 100 per call. confirm=true requires idempotency_key.7 params
Preview or submit reversible Sponsored Products negative keyword state updates through /sp/negativeKeywords or /sp/campaignNegativeKeywords. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
scopestringWhether the negative keyword IDs are ad-group-level or campaign-level records.one of
ad_group · campaignreasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sp_negative_keywordsPreview or submit irreversible Sponsored Products negative keyword archives through /sp/negativeKeywords/delete or /sp/campaignNegativeKeywords/delete. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.8 params
Preview or submit irreversible Sponsored Products negative keyword archives through /sp/negativeKeywords/delete or /sp/campaignNegativeKeywords/delete. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
scopestringWhether the negative keyword IDs are ad-group-level or campaign-level records.one of
ad_group · campaignreasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
negative_keyword_idsarrayarchive_acknowledgementbooleanRequired as true when confirm=true because negative keyword archive is irreversible.default: false
update_sp_negative_target_statePreview or submit reversible Sponsored Products negative target state updates through /sp/negativeTargets or /sp/campaignNegativeTargets. Max 100 per call. confirm=true requires idempotency_key.7 params
Preview or submit reversible Sponsored Products negative target state updates through /sp/negativeTargets or /sp/campaignNegativeTargets. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
scopestringWhether the negative target IDs are ad-group-level or campaign-level records.one of
ad_group · campaignreasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sp_negative_targetsPreview or submit irreversible Sponsored Products negative target archives through /sp/negativeTargets/delete or /sp/campaignNegativeTargets/delete. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.8 params
Preview or submit irreversible Sponsored Products negative target archives through /sp/negativeTargets/delete or /sp/campaignNegativeTargets/delete. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
scopestringWhether the negative target IDs are ad-group-level or campaign-level records.one of
ad_group · campaignreasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
negative_target_idsarrayarchive_acknowledgementbooleanRequired as true when confirm=true because negative target archive is irreversible.default: false
update_keyword_bidsPreview or submit keyword bid updates for Sponsored Products campaigns. Returns old and new bid values for each keyword. Max 100 keywords per call. Bid bounds and precision are enforced per marketplace currency. Always pre-reads current bids for audit trail. Defaults to previe...6 params
Preview or submit keyword bid updates for Sponsored Products campaigns. Returns old and new bid values for each keyword. Max 100 keywords per call. Bid bounds and precision are enforced per marketplace currency. Always pre-reads current bids for audit trail. Defaults to previe...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayArray of keyword bid updates (1-100 per call)
profile_idstringAd account profile ID (required for write operations)
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_target_bidsPreview or submit bid updates for Sponsored Products targeting clauses on /sp/targets, including ASIN product targets, category targets, and auto targets. Use target rows from get_keyword_performance where target IDs currently appear as keyword_id for rows with keyword_type TA...6 params
Preview or submit bid updates for Sponsored Products targeting clauses on /sp/targets, including ASIN product targets, category targets, and auto targets. Use target rows from get_keyword_performance where target IDs currently appear as keyword_id for rows with keyword_type TA...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayArray of Sponsored Products target bid updates (1-100 per call)
profile_idstringAd account profile ID (required for write operations)
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_keyword_statePreview or submit keyword state updates (ENABLED/PAUSED/PROPOSED) for Sponsored Products keywords. Max 100 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key.6 params
Preview or submit keyword state updates (ENABLED/PAUSED/PROPOSED) for Sponsored Products keywords. Max 100 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayKeyword state updates (1-100 per call)
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_campaign_biddingPreview or submit placement bid adjustment updates for a Sponsored Products campaign. Supports Top of Search (TOS) and Product Page bid multipliers. Percentage range: 0-900%. Pre-reads current values for audit trail. Defaults to preview; confirm=true requires idempotency_key.7 params
Preview or submit placement bid adjustment updates for a Sponsored Products campaign. Supports Top of Search (TOS) and Product Page bid multipliers. Percentage range: 0-900%. Pre-reads current values for audit trail. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
adjustmentsarrayPlacement bid adjustments (1-2 per call)
campaign_idstringCampaign ID to update
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_campaign_budgetPreview or submit a daily budget update for a Sponsored Products campaign. Budget bounds enforced per marketplace currency. Warns on changes exceeding 500%. Pre-reads current budget for audit trail. Defaults to preview; confirm=true requires idempotency_key.7 params
Preview or submit a daily budget update for a Sponsored Products campaign. Budget bounds enforced per marketplace currency. Warns on changes exceeding 500%. Pre-reads current budget for audit trail. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
budgetnumberNew daily budget in the active marketplace currency. Per-currency bounds and precision enforced after parsing.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
campaign_idstringCampaign ID to update
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_campaign_statePreview or submit campaign state updates (ENABLED/PAUSED/PROPOSED) for Sponsored Products campaigns. Max 100 per call. Pre-reads current state for audit trail. ARCHIVED is read-only here because Amazon campaign archives are irreversible; archive active campaigns with archive_c...6 params
Preview or submit campaign state updates (ENABLED/PAUSED/PROPOSED) for Sponsored Products campaigns. Max 100 per call. Pre-reads current state for audit trail. ARCHIVED is read-only here because Amazon campaign archives are irreversible; archive active campaigns with archive_c...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayCampaign state updates (1-100 per call)
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_campaign_audience_bid_adjustmentPreview or submit single audience bid adjustment updates for Sponsored Products campaigns. Max 100 campaigns per call. Percentage range: 0-900%. Pre-reads current values for audit trail. Defaults to preview; confirm=true requires idempotency_key.6 params
Preview or submit single audience bid adjustment updates for Sponsored Products campaigns. Max 100 campaigns per call. Percentage range: 0-900%. Pre-reads current values for audit trail. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayAudience bid adjustment updates (1-100 per call)
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_adgroup_bidPreview or submit default bid updates for Sponsored Products ad groups. Max 100 per call. Bid bounds enforced per marketplace currency. Warns on changes exceeding 500%. Pre-reads current bids for audit trail. Defaults to preview; confirm=true requires idempotency_key.6 params
Preview or submit default bid updates for Sponsored Products ad groups. Max 100 per call. Bid bounds enforced per marketplace currency. Warns on changes exceeding 500%. Pre-reads current bids for audit trail. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayAd group bid updates (1-100 per call)
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
create_keywordsPreview or submit exact, phrase, or broad keyword creation for Sponsored Products campaigns. Max 100 per call. Bid bounds enforced per marketplace currency. Defaults to preview; confirm=true requires idempotency_key.6 params
Preview or submit exact, phrase, or broad keyword creation for Sponsored Products campaigns. Max 100 per call. Bid bounds enforced per marketplace currency. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
keywordsarrayKeywords to create (1-100 per call)
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
create_negative_keywordsPreview or submit negative keyword creation for Sponsored Products campaigns. Items with ad_group_id are created as ad-group-level negatives; without are campaign-level. Max 100 per call. Defaults to preview; confirm=true requires idempotency_key.6 params
Preview or submit negative keyword creation for Sponsored Products campaigns. Items with ad_group_id are created as ad-group-level negatives; without are campaign-level. Max 100 per call. Defaults to preview; confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
negativesarrayNegative keywords to create (1-100 per call)
profile_idstringAd account profile ID
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_campaignsPreview or submit irreversible Sponsored Products campaign archive operations through Amazon's bulk archive endpoint. Max 100 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Products campaign archive operations through Amazon's bulk archive endpoint. Max 100 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
campaign_idsarrayCampaign IDs to archive (1-100 per call)
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because campaign archive is irreversible.default: false
archive_keywordsPreview or submit irreversible Sponsored Products keyword archive operations through Amazon's bulk archive endpoint. Max 100 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Products keyword archive operations through Amazon's bulk archive endpoint. Max 100 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAd account profile ID
keyword_idsarrayKeyword IDs to archive (1-100 per call)
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because keyword archive is irreversible.default: false
create_sb_targetsPreview or submit Sponsored Brands target creation through Amazon's Common Campaign Management POST /adsApi/v1/create/targets endpoint. Supports keyword, product, category, and theme targets. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Brands target creation through Amazon's Common Campaign Management POST /adsApi/v1/create/targets endpoint. Supports keyword, product, category, and theme targets. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
targetsarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
create_sb_negative_targetsPreview or submit Sponsored Brands negative target creation through Amazon's Common Campaign Management POST /adsApi/v1/create/targets endpoint with negative=true. Supports keyword, product, and category negative targets. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Brands negative target creation through Amazon's Common Campaign Management POST /adsApi/v1/create/targets endpoint with negative=true. Supports keyword, product, and category negative targets. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
negative_targetsarrayupdate_sb_target_bidsPreview or submit Sponsored Brands target bid updates through Amazon's Common Campaign Management POST /adsApi/v1/update/targets endpoint. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Brands target bid updates through Amazon's Common Campaign Management POST /adsApi/v1/update/targets endpoint. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sb_target_statePreview or submit reversible Sponsored Brands target state updates through Amazon's Common Campaign Management POST /adsApi/v1/update/targets endpoint. Use archive_sb_targets for permanent archive. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit reversible Sponsored Brands target state updates through Amazon's Common Campaign Management POST /adsApi/v1/update/targets endpoint. Use archive_sb_targets for permanent archive. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sb_negative_target_statePreview or submit reversible Sponsored Brands negative target state updates through Amazon's Common Campaign Management POST /adsApi/v1/update/targets endpoint. Use archive_sb_negative_targets for permanent archive. Max 100 per call. confirm=true requires idempotency_key.6 params
Preview or submit reversible Sponsored Brands negative target state updates through Amazon's Common Campaign Management POST /adsApi/v1/update/targets endpoint. Use archive_sb_negative_targets for permanent archive. Max 100 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sb_targetsPreview or submit irreversible Sponsored Brands target archives through Amazon's Common Campaign Management POST /adsApi/v1/delete/targets endpoint. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Brands target archives through Amazon's Common Campaign Management POST /adsApi/v1/delete/targets endpoint. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
target_idsarrayidempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired true when confirm=true because Sponsored Brands target archive is irreversible.default: false
archive_sb_negative_targetsPreview or submit irreversible Sponsored Brands negative target archives through Amazon's Common Campaign Management POST /adsApi/v1/delete/targets endpoint. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Brands negative target archives through Amazon's Common Campaign Management POST /adsApi/v1/delete/targets endpoint. Max 100 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
negative_target_idsarrayarchive_acknowledgementbooleanRequired true when confirm=true because Sponsored Brands negative target archive is irreversible.default: false
create_sb_campaignsPreview or submit Sponsored Brands campaign creation through Amazon Common Campaign Management POST /adsApi/v1/create/campaigns. Max 10 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Brands campaign creation through Amazon Common Campaign Management POST /adsApi/v1/create/campaigns. Max 10 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
campaignsarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sb_campaign_budgetPreview or submit Sponsored Brands campaign budget updates through Amazon Common Campaign Management POST /adsApi/v1/update/campaigns. Max 10 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Brands campaign budget updates through Amazon Common Campaign Management POST /adsApi/v1/update/campaigns. Max 10 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sb_campaign_statePreview or submit reversible Sponsored Brands campaign state updates through Amazon Common Campaign Management POST /adsApi/v1/update/campaigns. Use archive_sb_campaigns for permanent archive. Max 10 per call. confirm=true requires idempotency_key.6 params
Preview or submit reversible Sponsored Brands campaign state updates through Amazon Common Campaign Management POST /adsApi/v1/update/campaigns. Use archive_sb_campaigns for permanent archive. Max 10 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sb_campaignsPreview or submit irreversible Sponsored Brands campaign archives through Amazon Common Campaign Management POST /adsApi/v1/delete/campaigns. Max 10 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Brands campaign archives through Amazon Common Campaign Management POST /adsApi/v1/delete/campaigns. Max 10 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
campaign_idsarrayidempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired true when confirm=true because Sponsored Brands campaign archive is irreversible.default: false
create_sb_ad_groupsPreview or submit Sponsored Brands ad group creation through Amazon Common Campaign Management POST /adsApi/v1/create/adGroups. Max 10 per call. confirm=true requires idempotency_key. No ad-group bid field is exposed because no official public SB ad-group bid mutation proof wa...6 params
Preview or submit Sponsored Brands ad group creation through Amazon Common Campaign Management POST /adsApi/v1/create/adGroups. Max 10 per call. confirm=true requires idempotency_key. No ad-group bid field is exposed because no official public SB ad-group bid mutation proof wa...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
ad_groupsarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sb_ad_group_statePreview or submit reversible Sponsored Brands ad group state updates through Amazon Common Campaign Management POST /adsApi/v1/update/adGroups. Use archive_sb_ad_groups for permanent archive. Max 10 per call. confirm=true requires idempotency_key.6 params
Preview or submit reversible Sponsored Brands ad group state updates through Amazon Common Campaign Management POST /adsApi/v1/update/adGroups. Use archive_sb_ad_groups for permanent archive. Max 10 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sb_ad_groupsPreview or submit irreversible Sponsored Brands ad group archives through Amazon Common Campaign Management POST /adsApi/v1/delete/adGroups. Max 10 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Brands ad group archives through Amazon Common Campaign Management POST /adsApi/v1/delete/adGroups. Max 10 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
ad_group_idsarrayidempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired true when confirm=true because Sponsored Brands ad group archive is irreversible.default: false
create_sb_adsPreview or submit Sponsored Brands ad creation through Amazon Common Campaign Management POST /adsApi/v1/create/ads. The creative object must be user-supplied using Amazon's documented SBCreateCreative schema. Max 10 per call. confirm=true requires idempotency_key.6 params
Preview or submit Sponsored Brands ad creation through Amazon Common Campaign Management POST /adsApi/v1/create/ads. The creative object must be user-supplied using Amazon's documented SBCreateCreative schema. Max 10 per call. confirm=true requires idempotency_key.
Parameters* required
adsarrayactorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
update_sb_ad_statePreview or submit reversible Sponsored Brands ad state updates through Amazon Common Campaign Management POST /adsApi/v1/update/ads. Use archive_sb_ads for permanent archive. Max 10 per call. confirm=true requires idempotency_key.6 params
Preview or submit reversible Sponsored Brands ad state updates through Amazon Common Campaign Management POST /adsApi/v1/update/ads. Use archive_sb_ads for permanent archive. Max 10 per call. confirm=true requires idempotency_key.
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarrayprofile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_sb_adsPreview or submit irreversible Sponsored Brands ad archives through Amazon Common Campaign Management POST /adsApi/v1/delete/ads. Max 10 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.7 params
Preview or submit irreversible Sponsored Brands ad archives through Amazon Common Campaign Management POST /adsApi/v1/delete/ads. Max 10 per call. confirm=true requires idempotency_key and archive_acknowledgement=true.
Parameters* required
actorstringOptional actor/workflow label.
ad_idsarrayreasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired true when confirm=true because Sponsored Brands ad archive is irreversible.default: false
archive_sd_campaignsPreview or submit irreversible Sponsored Display campaign archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement...7 params
Preview or submit irreversible Sponsored Display campaign archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
campaign_idsarraySponsored Display campaigns to archive (1-20 per call).
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because Sponsored Display campaign archive is irreversible.default: false
archive_sd_ad_groupsPreview or submit irreversible Sponsored Display ad group archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement...7 params
Preview or submit irreversible Sponsored Display ad group archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
ad_group_idsarraySponsored Display ad groups to archive (1-20 per call).
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because Sponsored Display ad group archive is irreversible.default: false
archive_sd_product_adsPreview or submit irreversible Sponsored Display product ad archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgeme...7 params
Preview or submit irreversible Sponsored Display product ad archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgeme...
Parameters* required
actorstringOptional actor/workflow label.
ad_idsarraySponsored Display product ads to archive (1-20 per call).
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because Sponsored Display product ad archive is irreversible.default: false
archive_sd_targetsPreview or submit irreversible Sponsored Display target archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement=t...7 params
Preview or submit irreversible Sponsored Display target archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowledgement=t...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
target_idsarraySponsored Display targets to archive (1-20 per call).
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
archive_acknowledgementbooleanRequired as true when confirm=true because Sponsored Display target archive is irreversible.default: false
archive_sd_negative_targetsPreview or submit irreversible Sponsored Display negative target archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowle...7 params
Preview or submit irreversible Sponsored Display negative target archive operations through Amazon's documented delete-to-archive endpoint. Max 20 per call. Pre-reads current state for audit trail. Defaults to preview; confirm=true requires idempotency_key and archive_acknowle...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
negative_target_idsarraySponsored Display negative targets to archive (1-20 per call).
archive_acknowledgementbooleanRequired as true when confirm=true because Sponsored Display negative target archive is irreversible.default: false
update_sd_target_bidsPreview or submit Sponsored Display target bid updates through Amazon's documented PUT /sd/targets endpoint. Request body is a JSON array of targetId/bid objects. Max 100 per call. Pre-reads current state and verifies readback. Defaults to preview; confirm=true requires idempo...6 params
Preview or submit Sponsored Display target bid updates through Amazon's documented PUT /sd/targets endpoint. Request body is a JSON array of targetId/bid objects. Max 100 per call. Pre-reads current state and verifies readback. Defaults to preview; confirm=true requires idempo...
Parameters* required
actorstringOptional actor/workflow label.
reasonstringOptional audit reason.
confirmbooleanFalse previews; true submits Ads write.default: false
updatesarraySponsored Display target bid updates (1-100 per call). target_id values must be unique.
profile_idstringAmazon Ads profile ID.
idempotency_keystringRequired with confirm=true; blocks duplicate Ads writes.
agentcentral MCP
agentcentral is a hosted Amazon MCP server for Amazon sellers: an Amazon Seller Central MCP server and Amazon Ads MCP server for Claude, ChatGPT, Cursor, Claude Code, OpenClaw, and other HTTP-capable MCP clients.
It connects AI clients to Amazon Ads, Seller Central, inventory, orders, catalog, rankings, finance, and fulfillment data through the hosted Streamable HTTP endpoint at https://mcp.agentcentral.to/mcp.
This is not just an export layer. agentcentral is an operational MCP server with fast factual reads plus safe guarded writes: scoped API keys, read/write tool separation, previews, guardrails, and audited write results. The hosted endpoint currently exposes 141 domain-scoped tools and 145 production tools total. This public repo contains registry metadata and a thin stdio introspection stub; live tool execution happens only through the hosted endpoint. The local stub lists the hosted catalog plus one setup helper for discovery, so it is intentionally one tool larger than the hosted production catalog.
Connect
{
"mcpServers": {
"agentcentral": {
"url": "https://mcp.agentcentral.to/mcp",
"headers": {
"Authorization": "Bearer ac_live_<YOUR_API_KEY>"
}
}
}
}
Claude custom connectors use a signed connector URL generated in the agentcentral dashboard.
Setup
- Create an account at https://agentcentral.to/signup.
- Connect Amazon Ads and Seller Central through Amazon OAuth.
- Create a scoped API key or signed Claude connector URL.
- Add the MCP endpoint to Claude, ChatGPT, Cursor, Claude Code, OpenClaw, or another remote-MCP-capable client.
Full setup guide: https://agentcentral.to/amazon-seller-central-mcp-claude
What agents can access
- Amazon Ads campaign, ad group, keyword, target, search term, placement, budget pacing, TACOS, DSP, Brand Store, and Amazon Attribution data
- Seller Central inventory, orders, returns, reimbursements, listings, suppressed listings, inbound shipments, and FBA/AWD stock facts
- Catalog details, sales ranks, A+ Content status, variations, listing quality, listing issues, reviews, and keyword ranks
- Finance, profitability, payment transaction, settlement, fulfillment, MCF shipping, and MCF order data
- Guarded write tools for supported Amazon Ads, catalog, listing, price, inventory quantity, and MCF operations
agentcentral returns factual seller data, source fields, deterministic metrics, classifications, and audited write results. It is not a recommendation engine.
Discovery URLs
- Amazon Seller Central MCP: https://agentcentral.to/amazon-seller-central-mcp
- Amazon Ads MCP server: https://agentcentral.to/amazon-ads-mcp-server
- Amazon MCP server for Claude: https://agentcentral.to/amazon-mcp-server-for-claude
- Amazon MCP server for ChatGPT: https://agentcentral.to/amazon-mcp-server-for-chatgpt
- Amazon Seller Central ChatGPT: https://agentcentral.to/amazon-seller-central-chatgpt
- Claude quickstart: https://agentcentral.to/docs/quickstart/claude
- ChatGPT quickstart: https://agentcentral.to/docs/quickstart/chatgpt
Security
- Amazon OAuth connections
- Encrypted Amazon refresh tokens
- Per-tenant data isolation
- Scoped API keys and read-only configurations
- Read/write tool separation
- Guardrails, previews, and audit logs for supported write tools
Example prompts
- "Use the Amazon Ads MCP server to query Sponsored Products search terms with spend, clicks, attributed sales, and TACOS for the last 30 days."
- "Which SKUs are below 30 days of FBA cover? Include current stock, inbound units, sales velocity, and suppressed listing status."
- "Use the Amazon Seller Central MCP server in Claude to inspect orders, shipment status, and fulfillment facts from the last 7 days."
- "Compare TACOS, ad spend, and sales by ASIN this month."
- "Find suppressed listings and show the source-provided suppression reasons."
- "Which Amazon Ads campaigns changed budget in the last 14 days?"
Local stdio stub (introspection only)
This repo ships a minimal stdio MCP server so directories and clients can introspect the public tool catalog without an agentcentral account. It does not execute tool calls. Every call returns a pointer to the hosted endpoint and setup guide.
The stub is not published to npm. Clone this repository or use the Docker example below if a directory/client needs local stdio introspection; for real usage, configure the hosted remote MCP endpoint above.
docker build -t agentcentral-mcp .
docker run --rm -i agentcentral-mcp
Or via Node:
npm install
npm run build
node dist/index.js
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
TransportHTTP
AuthRequired
UpdatedMay 26, 2026
