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_recommendations lists Amazon's optimization suggestions; ads_apply_recommendations applies the ones you accept.
  • Rules instead of manual edits — ads_sp_create_optimization_rules and ads_associate_optimization_rules_to_campaign set schedule-based bid rules.
  • Portfolios — ads_list_portfolios, ads_create_portfolio and ads_update_portfolio group campaigns under a shared budget.
  • Full snapshots — ads_campaign_export and its siblings export every entity; ads_get_export downloads 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)

tools/call
{
  "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}}'
Early access — the Tool API is open on request, contact us.

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.

ToolAccessWhat it does
ads_sp_bulk_createwriteCreate 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_campaignreadQuery (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_campaignwriteCreate 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_groupwriteCreate 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_adwriteCreate ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_create_targetwriteCreate 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_biddestructiveChange ONE target's (keyword, product or audience target) bid.
ads_get_theme_based_bid_recommendation_for_ad_group_v1readSponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one.
ads_get_ranked_keyword_recommendationreadSponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs.
ads_get_historyreadGet the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads.
query_report_datareadQuery the synced report warehouse (rpt_* tables) — rows without calling Amazon.

Campaigns, ad groups, ads and targets for every ad type:

ToolAccessWhat it does
ads_create_adwriteCreate ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_create_ad_associationwriteCreate 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_groupwriteCreate 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_campaignwriteCreate 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_targetwriteCreate 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_addestructiveDelete (archive) ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_delete_ad_associationdestructiveDelete (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_groupdestructiveDelete (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_campaigndestructiveDelete (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_targetdestructiveDelete (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_adreadQuery (read) ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_query_ad_associationreadQuery (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_groupreadQuery (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_campaignreadQuery (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_targetreadQuery (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_addestructiveUpdate ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_update_ad_associationdestructiveUpdate 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_groupdestructiveUpdate 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_campaigndestructiveUpdate 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_budgetdestructiveChange ONE campaign's budget amount — nothing else about the campaign.
ads_update_campaign_statedestructiveEnable or pause ONE campaign — nothing else about it.
ads_update_targetdestructiveUpdate 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_biddestructiveChange ONE target's (keyword, product or audience target) bid.

Sponsored Products recommendations, portfolios, rules and exports:

ToolAccessWhat it does
ads_create_portfoliowriteCreate portfolios (cross-product: Sponsored Products, Brands and Display).
ads_get_category_recommendations_for_asinsreadSponsored 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_brandsreadSponsored Products: brands Amazon recommends excluding from targeting (no input needed).
ads_get_ranked_keyword_recommendationreadSponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs.
ads_get_refinements_for_categoryreadSponsored Products: the refinements (brand / age-range / genre facets) targetable WITHIN a category — e.g.
ads_get_theme_based_bid_recommendation_for_ad_group_v1readSponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one.
ads_list_portfoliosreadList portfolios (group campaigns across Sponsored Products, Brands and Display for shared budget caps and reporting).
ads_search_brandsreadSponsored 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_createwriteCreate 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_recommendationsreadSponsored 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_recommendationsreadSponsored Products: suggested target ASINs (product targets) for your advertised ASINs — competitor / complementary ASINs Amazon considers relevant, each with the themes that produ
ads_update_portfoliodestructiveUpdate portfolios (cross-product: Sponsored Products, Brands and Display).
ads_ad_exportreadSubmit a bulk export of every product ad across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file.
ads_ad_group_exportreadSubmit a bulk export of every ad group across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file.
ads_apply_recommendationsdestructiveAccept Amazon-generated Sponsored Products campaign recommendations — Amazon applies the proposed change to the campaign.
ads_associate_optimization_rules_to_campaigndestructiveAttach Sponsored Products bid optimization rules to a campaign — a rule changes nothing until it is associated.
ads_campaign_exportreadSubmit a bulk export of every campaign across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file.
ads_create_optimization_ruledestructiveSponsored 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_ruledestructiveSponsored 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_reportreadRequest 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_reportreadPoll 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_rulereadSponsored Products: get one rule-based-bidding rule by its id.
ads_get_exportreadPoll 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_historyreadGet the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads.
ads_get_optimization_rule_eligibilityreadSponsored 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_notificationreadSponsored Products: the daily health-check for a rule-based-bidding rule — whether Amazon has silently disabled it.
ads_insights_get_audiences_overlapping_audiencesreadGet the audiences that OVERLAP one given audience segment — audience-overlap insights for a single audienceId, not a catalog of audiences.
ads_list_recommendationsreadList 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_rulesreadSearch 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_ruleswriteCreate a Sponsored Products bid optimization rule — schedule or performance bid rules that raise bids automatically.
ads_sp_get_all_rule_eventsreadSponsored 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_rulesdestructiveUpdate 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_exportreadSubmit 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_ruledestructiveSponsored Products: update a rule-based-bidding rule — same shape as ads_create_optimization_rule plus campaignOptimizationId.
ads_update_recommendationdestructiveModify 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.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude