Sponsored Brands

Headline search ads that show your brand — campaigns, ad groups, creatives, keywords and bids — by conversation or by code.

In short

Sponsored Brands campaigns use the same campaign, ad group, ad and target tools as every other ad type, filtered to Sponsored Brands. Your agent asks Amazon for keyword and bid suggestions before it proposes anything.

In your daily workflow

  • Start from your brand — ads_get_brands lists the brands registered under your Ads profile; ads_list_assets finds the logos and images your creatives can use.
  • Pick keywords — ads_get_keyword_recommendations suggests keywords for a Sponsored Brands campaign; ads_get_bids_recommendations returns Amazon's suggested bids.
  • Build it — ads_create_campaign, ads_create_ad_group, ads_create_ad and ads_create_target create the entities; ads_query_campaign lists what is live.
  • Budget — ads_sb_get_budget_recommendations tells you where a campaign is losing impressions to budget.
  • Performance — your synced Sponsored Brands reports answer through query_report_data.

Try asking

"Create a Sponsored Brands campaign for my brand with the three best keywords Amazon suggests — show me the plan first."

"Get bid recommendations for my Sponsored Brands keywords."

Listing campaigns, both ways

MCP — you ask: "List my Sponsored Brands campaigns." Your agent calls ads_query_campaign.

In an AI client (MCP)

tools/call
{
  "name": "ads_query_campaign",
  "arguments": {
    "store": "myStore-US",
    "countryCode": "US",
    "body": {
      "adProductFilter": {
        "include": [
          "SPONSORED_BRANDS"
        ]
      },
      "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_BRANDS"]},"maxResults":100}}'
Early access — the Tool API is open on request, contact us.

Write access required

Creating and changing campaigns, ads and targets changes your Ads account, so the store needs Ads write access (see Stay in control). Recommendations and reads work with read access.

Tools on this page

ToolAccessWhat it does
ads_get_brandsreadSponsored Brands: list the brands registered under this advertiser profile — brandId, brandRegistryName and (sellers only) the brandEntityId the Store insights tools take (ads_get_
ads_list_assetsreadSponsored Brands: list a brand's Stores asset library — logos, images, lifestyle imagery, video — every asset tied to the supplied entity id.
ads_get_keyword_recommendationsreadSponsored Brands: suggested keywords, from ASINs or a landing page URL.
ads_get_bids_recommendationsreadSponsored Brands: suggested bids for keywords, product targets or themes.
ads_sb_get_budget_recommendationsreadDaily-budget recommendations and missed-opportunity estimates for EXISTING Sponsored Brands campaigns (SP: ads_sp_get_budget_recommendations; a not-yet-created SP campaign: ads_get
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
query_report_datareadQuery the synced report warehouse (rpt_* tables) — rows without calling Amazon.

FAQ

Why are the campaign tools the same as Sponsored Products?

Amazon's current Ads API treats campaigns, ad groups, ads and targets the same way for every ad type; you choose the ad type in the request. See Sponsored Products.

Where are the reports?

See Ad reports and Synced reports.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude