Sponsored Products
Launch, tune and audit Sponsored Products campaigns — campaigns, ad groups, keywords, product targets, bids, negatives and Amazon's own recommendations — by conversation or by code.
In short
Describe the campaign you want; your agent builds the whole structure, asks Amazon for the suggested bid, and shows you the plan before anything goes live. Day to day it reads performance from your synced ad reports and changes only the bids and targets you approve.
Launch a campaign, step by step
Describe it in one sentence
"Create a Sponsored Products campaign for B0EXAMPLE1 with a daily budget I set, targeting 'organic protein powder'." Your agent plans the campaign, an ad group, the product ad and the keyword, and shows you the structure first.
Ask Amazon what to bid
ads_get_theme_based_bid_recommendation_for_ad_group_v1 returns Amazon's suggested bids for the keywords and targets; ads_get_ranked_keyword_recommendation suggests more keywords worth adding.
Create it in one request
ads_sp_bulk_create creates the campaign, ad groups, keywords and product ads in one atomic request — much faster than one entity at a time. Single entities go through ads_create_campaign, ads_create_ad_group, ads_create_ad and ads_create_target.
Tune it every week
query_report_data reads campaign, keyword and search-term performance from your synced SP reports. Your agent writes the proposed bid changes to your sheet; on your go-ahead ads_update_target_bid applies them. Negative keywords and targets cut wasted spend; ads_get_history shows the last 90 days of changes.
In your daily workflow
- Amazon's own tips —
ads_list_recommendationslists Amazon's optimization suggestions;ads_apply_recommendationsapplies the ones you accept. - Rules instead of manual edits —
ads_sp_create_optimization_rulesandads_associate_optimization_rules_to_campaignset schedule-based bid rules. - Portfolios —
ads_list_portfolios,ads_create_portfolioandads_update_portfoliogroup campaigns under a shared budget. - Full snapshots —
ads_campaign_exportand its siblings export every entity;ads_get_exportdownloads the file.
Try asking
"Create a Sponsored Products campaign for B0EXAMPLE1 targeting 'organic protein powder', with Amazon's suggested bid — show me the structure before you create it."
"Raise the bids on these keywords 10% toward the suggested bid — write them to the sheet first, I'll confirm before you submit."
Listing campaigns, both ways
The same tool and the same arguments — through your AI client, or from your own code.
MCP — you ask: "List my Sponsored Products campaigns." Your agent calls ads_query_campaign and pages through the results.
In an AI client (MCP)
{
"name": "ads_query_campaign",
"arguments": {
"store": "myStore-US",
"countryCode": "US",
"body": {
"adProductFilter": {
"include": [
"SPONSORED_PRODUCTS"
]
},
"maxResults": 100
}
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_query_campaign \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"US","body":{"adProductFilter":{"include":["SPONSORED_PRODUCTS"]},"maxResults":100}}'Write access required
Creating campaigns, changing bids, budgets and targets, and applying recommendations change your Ads account, so the store needs Ads write access (see Stay in control). Reading campaigns, recommendations and reports works with read access.
Tools on this page
Pulled from the catalog at build time, each with its own access label.
| Tool | Access | What it does |
|---|---|---|
ads_sp_bulk_create | write | Create complete Sponsored Products campaign structures in one call (Amazon Ads API v1) — campaign → ad groups → product ads → targets, with the created ids chained server-side. |
ads_query_campaign | read | Query (read) advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon |
ads_create_campaign | write | Create advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon DSP; t |
ads_create_ad_group | write | Create ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_create_ad | write | Create ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_create_target | write | Create targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negative=true |
ads_update_target_bid | destructive | Change ONE target's (keyword, product or audience target) bid. |
ads_get_theme_based_bid_recommendation_for_ad_group_v1 | read | Sponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one. |
ads_get_ranked_keyword_recommendation | read | Sponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs. |
ads_get_history | read | Get the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads. |
query_report_data | read | Query the synced report warehouse (rpt_* tables) — rows without calling Amazon. |
Campaigns, ad groups, ads and targets for every ad type:
| Tool | Access | What it does |
|---|---|---|
ads_create_ad | write | Create ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_create_ad_association | write | Create ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the product link in |
ads_create_ad_group | write | Create ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_create_campaign | write | Create advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon DSP; t |
ads_create_target | write | Create targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negative=true |
ads_delete_ad | destructive | Delete (archive) ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_delete_ad_association | destructive | Delete (archive) ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the produc |
ads_delete_ad_group | destructive | Delete (archive) ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_delete_campaign | destructive | Delete (archive) advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Ama |
ads_delete_target | destructive | Delete (archive) targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (neg |
ads_query_ad | read | Query (read) ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_query_ad_association | read | Query (read) ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the product li |
ads_query_ad_group | read | Query (read) ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_query_campaign | read | Query (read) advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon |
ads_query_target | read | Query (read) targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negativ |
ads_update_ad | destructive | Update ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_update_ad_association | destructive | Update ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the product link in |
ads_update_ad_group | destructive | Update ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_update_campaign | destructive | Update advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon DSP; t |
ads_update_campaign_budget | destructive | Change ONE campaign's budget amount — nothing else about the campaign. |
ads_update_campaign_state | destructive | Enable or pause ONE campaign — nothing else about it. |
ads_update_target | destructive | Update targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negative=true |
ads_update_target_bid | destructive | Change ONE target's (keyword, product or audience target) bid. |
Sponsored Products recommendations, portfolios, rules and exports:
| Tool | Access | What it does |
|---|---|---|
ads_create_portfolio | write | Create portfolios (cross-product: Sponsored Products, Brands and Display). |
ads_get_category_recommendations_for_asins | read | Sponsored Products: category targets recommended for a list of ASINs — the coarse half of SP product targeting; narrow one further with ads_get_refinements_for_category. |
ads_get_negative_brands | read | Sponsored Products: brands Amazon recommends excluding from targeting (no input needed). |
ads_get_ranked_keyword_recommendation | read | Sponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs. |
ads_get_refinements_for_category | read | Sponsored Products: the refinements (brand / age-range / genre facets) targetable WITHIN a category — e.g. |
ads_get_theme_based_bid_recommendation_for_ad_group_v1 | read | Sponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one. |
ads_list_portfolios | read | List portfolios (group campaigns across Sponsored Products, Brands and Display for shared budget caps and reporting). |
ads_search_brands | read | Sponsored Products: search for a brand by name, to exclude it from targeting (negative brand target) — use this to find a specific named competitor. |
ads_sp_bulk_create | write | Create complete Sponsored Products campaign structures in one call (Amazon Ads API v1) — campaign → ad groups → product ads → targets, with the created ids chained server-side. |
ads_sp_get_budget_recommendations | read | Sponsored Products: the recommended daily budget and missed opportunities for existing campaigns — campaigns that are budget-capped, losing impressions/clicks/sales because they ru |
ads_sp_get_product_recommendations | read | Sponsored Products: suggested target ASINs (product targets) for your advertised ASINs — competitor / complementary ASINs Amazon considers relevant, each with the themes that produ |
ads_update_portfolio | destructive | Update portfolios (cross-product: Sponsored Products, Brands and Display). |
ads_ad_export | read | Submit a bulk export of every product ad across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file. |
ads_ad_group_export | read | Submit a bulk export of every ad group across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file. |
ads_apply_recommendations | destructive | Accept Amazon-generated Sponsored Products campaign recommendations — Amazon applies the proposed change to the campaign. |
ads_associate_optimization_rules_to_campaign | destructive | Attach Sponsored Products bid optimization rules to a campaign — a rule changes nothing until it is associated. |
ads_campaign_export | read | Submit a bulk export of every campaign across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file. |
ads_create_optimization_rule | destructive | Sponsored Products rule-based bidding — hand bid control to Amazon under a ROAS guardrail you declare; Amazon raises and lowers the campaign's base bids itself to increase conversi |
ads_delete_campaign_optimization_rule | destructive | Sponsored Products: delete a rule-based-bidding rule — unlike ads_sp_update_optimization_rules's API (which has no delete), this one really does support delete; the campaign return |
ads_generate_brand_metrics_report | read | Request a Brand Metrics report — your brand's shopper-funnel metrics in a category against category peers (engaged-shopper rate, customer conversion rate, new-to-brand customer rat |
ads_get_brand_metrics_report | read | Poll a Brand Metrics report; when the server sees it finished, the same call also downloads the file, so there is no separate download step. |
ads_get_campaign_optimization_rule | read | Sponsored Products: get one rule-based-bidding rule by its id. |
ads_get_export | read | Poll a bulk export submitted with ads_campaign_export / ads_ad_group_export / ads_target_export / ads_ad_export; downloads the file once status=COMPLETED. |
ads_get_history | read | Get the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads. |
ads_get_optimization_rule_eligibility | read | Sponsored Products: check which campaigns are eligible for rule-based bidding (a ROAS guardrail Amazon manages itself) before creating a rule with ads_create_optimization_rule — Am |
ads_get_rule_notification | read | Sponsored Products: the daily health-check for a rule-based-bidding rule — whether Amazon has silently disabled it. |
ads_insights_get_audiences_overlapping_audiences | read | Get the audiences that OVERLAP one given audience segment — audience-overlap insights for a single audienceId, not a catalog of audiences. |
ads_list_recommendations | read | List Amazon-generated recommendations for SP, SB, SD and ST campaigns (budget, bid, bidding strategy, new keywords, new campaigns, …) — filter by AD_PRODUCT. |
ads_search_optimization_rules | read | Search Sponsored Products bid optimization rules — rules that raise bids on a SCHEDULE or, with apiVersion='v2', while a PERFORMANCE condition holds (ROAS, CVR, CTR, …). |
ads_sp_create_optimization_rules | write | Create a Sponsored Products bid optimization rule — schedule or performance bid rules that raise bids automatically. |
ads_sp_get_all_rule_events | read | Sponsored Products: list the special shopping events (Prime Day, Black Friday, …) with Amazon's suggested date range in this profile's marketplace. |
ads_sp_update_optimization_rules | destructive | Update a Sponsored Products bid optimization rule — Amazon replaces the rule, it does not merge, so send the FULL rule object(s) including optimizationRuleId. |
ads_target_export | read | Submit a bulk export of every targeting clause (keywords, product targets and all negatives) across Sponsored Products, Brands and Display — an asynchronous full snapshot in one fi |
ads_update_optimization_rule | destructive | Sponsored Products: update a rule-based-bidding rule — same shape as ads_create_optimization_rule plus campaignOptimizationId. |
ads_update_recommendation | destructive | Modify one Amazon-generated Sponsored Products campaign recommendation before accepting it. |
FAQ
Where does performance data come from?
From your synced ad reports — query_report_data answers instantly without waiting on Amazon. See Synced reports and Ad reports.
Will my agent change bids on its own?
Not unless you tell it to. The usual pattern is: write the proposal to the sheet, you review, then it submits.
What about budgets?
ads_campaigns_budget_usage shows which campaigns ran out this week; budget rules are on Advertising account and the other ad types on Sponsored Brands and Sponsored Display.
Is there a skill for this?
Yes — the amazon-ads skill. See Install the skills.