Skip to main content

​
Amazon Ads Integration

Adspirer’s newest ad platform brings Amazon advertising to your AI assistant. Create and manage Sponsored Products, Sponsored Brands, and Sponsored Display campaigns with 61 specialized tools. Build campaigns from your ASINs and SKUs, run AUTO or MANUAL keyword targeting, get Amazon-native bid and keyword recommendations, and track ACOS and ROAS — all from a conversation. Multi-region advertiser profiles (NA, EU, FE) are discovered and routed automatically, and every campaign is created PAUSED so you can review before it spends.

​
Prerequisites

​
Connecting Amazon Ads

Adspirer connects to Amazon Ads through OAuth using Login with Amazon (LwA). Once you’ve set up Adspirer with your AI client, connect Amazon:
  1. Open your AI assistant (ChatGPT, Claude, Claude Code, etc.)
  2. Say: “Connect my Amazon Ads account”
  3. Adspirer opens your browser for Amazon authorization
  4. Sign in with Login with Amazon and approve the requested permissions (read campaign data, create campaigns, manage budgets)
  5. On connect, Adspirer imports each Amazon advertiser profile as an ad account — the first becomes active, and you can activate the others later
Adspirer discovers advertiser profiles across all three Amazon regions (NA, EU, and FE) and routes requests to the correct one automatically. Tokens refresh server-side, and your credentials are never stored client-side. Verify the connection:
You should see your Amazon advertiser profiles listed with profile name, account ID, region, and active status. To target a specific Amazon account, the assistant uses that profile’s ID (profile_id) — find them anytime with list_amazon_profiles.
There is no Amazon sandbox — campaigns run against production. To protect your spend, Adspirer creates everything PAUSED so you can review the campaign before launching it.

​
What You Can Do (61 Tools)

​
Accounts

  • list_amazon_profiles — List your Amazon advertiser profiles across NA, EU, and FE, with profile IDs, regions, and active status
  • list_amazon_brands — List the Brand Registry entities on a profile, with each brand’s brandEntityId — the value sellers must pass to create Sponsored Brands campaigns

​
Campaign Management (SP + SB + SD)

  • list_amazon_campaigns — List campaigns across Sponsored Products, Brands, and Display with status and budget
  • create_amazon_sp_campaign — Create a Sponsored Products campaign (created PAUSED)
  • create_amazon_sb_campaign — Create a Sponsored Brands campaign (created PAUSED)
  • create_amazon_sd_campaign — Create a Sponsored Display campaign (created PAUSED)
  • update_amazon_campaigns — Update name, budget, or bidding strategy across campaign types
  • pause_amazon_campaigns — Pause one or more campaigns
  • resume_amazon_campaigns — Resume paused campaigns
  • delete_amazon_campaigns — Archive campaigns
  • list_amazon_ad_groups / create_amazon_ad_groups / update_amazon_ad_groups / delete_amazon_ad_groups — Manage ad groups within Sponsored Products campaigns
  • list_amazon_product_ads / add_amazon_product_ads / update_amazon_product_ads / delete_amazon_product_ads — Manage the product ads (your ASINs/SKUs) inside each ad group
  • list_amazon_keywords / add_amazon_keywords / update_amazon_keywords / delete_amazon_keywords — Manage keywords for MANUAL targeting (bids, match types)
  • list_amazon_negative_keywords / add_amazon_negative_keywords / delete_amazon_negative_keywords — Block irrelevant search terms to cut wasted spend
  • list_amazon_targets / add_amazon_targets / update_amazon_targets / delete_amazon_targets — Manage product and category targeting
  • add_amazon_negative_product_targets — Exclude ASINs or brands so your Sponsored Products ads stop showing on those product pages, at ad group or campaign level
  • check_amazon_product_eligibility — Check whether ASINs or SKUs can advertise (Sponsored Products, Brands, or Display), with the reason for each one that can’t
  • list_amazon_sb_ad_groups — List Sponsored Brands ad groups
  • list_amazon_sb_ads / update_amazon_sb_ads / create_amazon_sb_ad — Manage Sponsored Brands ads across all 7 ad types (productCollection, video, brandVideo, storeSpotlight, autoCollection, manualCollection, productCollectionExtended)
  • list_amazon_sb_creatives / update_amazon_sb_creative — Manage Sponsored Brands creative assets
  • list_amazon_sb_keywords / add_amazon_sb_keywords / update_amazon_sb_keywords / delete_amazon_sb_keywords — Manage Sponsored Brands keywords
  • add_amazon_sb_negative_keywords — Add negative keywords to Sponsored Brands campaigns
  • list_amazon_sb_targets / add_amazon_sb_targets / update_amazon_sb_targets — Manage Sponsored Brands product and category targets
  • add_amazon_sb_themes — Add theme-based targets to Sponsored Brands campaigns

​
Creative Assets

  • upload_amazon_asset — Upload a creative asset (for example a brand logo required by productCollection ads)
  • search_amazon_assets — Find existing assets in your Amazon account library
  • get_amazon_moderation — Read an ad’s review status: APPROVED, IN_PROGRESS, REJECTED, or FAILED, broken out per component (image, text, video). On a rejection you get the policy violation and what it objected to, instead of an ad that silently never runs. Works for Sponsored Products, Sponsored Display, and Sponsored Brands

Find out why an Amazon ad isn't running.

Open in Cursor
Sponsored Products ad extensions are console-only. Amazon’s Ads API accepts ad extensions for Sponsored Brands, Sponsored Display, and Amazon DSP, but not for Sponsored Products — those have to be created in the Amazon Ads console. Ask for one on a Sponsored Products campaign and Adspirer tells you that plainly rather than returning Amazon’s cryptic ACTION_NOT_SUPPORTED.

​
Recommendations & Budget Intelligence

  • get_amazon_keyword_recommendations — Suggested Sponsored Products keywords for your ASINs
  • get_amazon_bid_recommendations — Suggested Sponsored Products bids by keyword or target
  • get_amazon_sb_keyword_recommendations — Suggested keywords for Sponsored Brands
  • get_amazon_sb_bid_recommendations — Suggested bids for Sponsored Brands
  • get_amazon_budget_recommendations — Recommended budget changes based on performance
  • get_amazon_budget_usage — How much of each campaign’s budget is being consumed

​
Reporting & Analytics

  • get_amazon_campaign_performance — Campaign metrics including impressions, clicks, spend, sales, ACOS, and ROAS
  • get_amazon_search_terms — The actual search terms shoppers used to find your ads
  • get_amazon_report — Retrieve an async Amazon report by report ID once it’s ready

​
Amazon-Specific Analytics

  • analyze_amazon_wasted_spend — Find keywords and targets spending without converting
  • optimize_amazon_budget — Budget reallocation recommendations based on ACOS and ROAS
  • get_amazon_product_performance — Per-ASIN/SKU performance breakdown
  • analyze_amazon_placements — Compare performance across placements (top of search, product pages, rest of search)
  • analyze_amazon_targeting — Evaluate keyword and product targeting effectiveness
  • get_amazon_purchased_products — Cross-sell view of what shoppers actually bought after clicking your ads

​
Power Tool

  • amazon_unified_api — Direct access to Amazon’s Advertising API for advanced operations not covered by the dedicated tools above
When you build product targets through it, a product target takes matchType PRODUCT_EXACT, PRODUCT_SIMILAR, PRODUCT_COMPLEMENTS or PRODUCT_REMARKETING, with the ASIN as product: {productId}. An update item must not carry adProduct (a create item must). To remove an audience bid adjustment, send that audience with percentage: null; an empty list changes nothing, and 0 sets the adjustment to 0%.

​
Large accounts: paging through long lists

Accounts with thousands of product ads or a big asset library used to hit a wall — a long list would be cut off partway through, and the tail was simply unreachable. Three places now page properly:
  • list_amazon_product_ads returns a continuation token when there is more to fetch, so your assistant can keep going until the list is done. You can also narrow it up front by state or by ad group instead of paging through everything.
  • search_amazon_assets pages through the asset library rather than stopping at the first batch.
  • get_amazon_product_performance returns the page you asked for. It used to always render the top 20 no matter which page you requested, so ASIN 40 was invisible.
Rows come back compact, which is what makes a long list survive the trip in one piece. Reports stay inside the ad product you ask for. Sponsored Products, Sponsored Brands, and Sponsored Display share one analytics store, and a Sponsored Brands campaign report used to come back with Sponsored Products and Display campaigns mixed in, plus account-wide totals. Campaign, search-term, targeting, product, ad-group, and placement reads now return only the product you requested. ad_product accepts SP, SB, SD or the full names, and anything else is rejected with an error instead of quietly defaulting to Sponsored Products. Campaign lists say how many there are. list_amazon_campaigns shows “10 of 37” when a product has more campaigns than one page holds, and returns a next_token you pass back to fetch the next page. Paging works one ad product at a time, so set ad_product to sp, sb or sd before you page; with all, the reply tells you which single-product call to make. Sponsored Display now honors the state filter, as Sponsored Products and Sponsored Brands already did. Reads carry the IDs. Rows from get_amazon_report and analyze_amazon_targeting include the campaign, ad group, and keyword or target ID, so two targets with the same text in different campaigns can be told apart without another call. analyze_amazon_targeting also says “top 20 of 312 by spend” instead of leaving you to guess that rows are hidden. Queries through amazon_unified_api come back as a compact table with an honest count and a next_token, not a raw dump cut off after two rows.

Reach past the first page of a large Amazon account.

Open in Cursor

​
Product Targeting and Pre-Flight Checks

Target competitor products and categories. create_amazon_sp_campaign takes product_targets on MANUAL campaigns: a list of {type, value, match, bid} entries where type is ASIN or CATEGORY, value is the ASIN or category ID, and match is EXACT or EXPANDED (ASIN only). Category targets accept refinements for brand, price range, and minimum rating. Pass keywords, product targets, or both. Amazon doesn’t allow them in one ad group, so when you pass both, keywords stay in the first ad group and product targets get their own ”- Products” ad group. If the targeting ends up with zero targets, the create reports a failure with the step to resume from, not a success. add_amazon_negative_product_targets is the other half: exclude ASINs or brands at the ad group or campaign level. Eligibility is checked before anything is created. Out-of-stock, suppressed, Buy Box-less, restricted-category, and parent-ASIN products used to fail after the campaign existed, leaving an empty shell. create_amazon_sp_campaign now checks eligibility first. If none of your products can advertise, nothing is created and you get the reason per product. If some can’t, the campaign advertises the eligible ones and lists the ones it skipped. Run check_amazon_product_eligibility yourself while planning. Names and keywords are cleaned before they go to Amazon. Amazon rejects a whole create over characters like ·, –, —, |, and £/€/¥ in a campaign or ad group name, or over a leading +, quotes, or more than 10 words in a keyword. Separators become -, currency symbols become their ISO code, emoji are removed, and accented and non-Latin letters stay. The result tells you what changed (name_adjusted_from), and keywords that can’t be fixed are dropped with a reason (dropped_keywords) instead of failing the batch. A MANUAL campaign left with no keywords and no product targets reports a failure.

Target competitor ASINs, with a pre-flight check.

Open in Cursor
Sponsored Products campaigns follow this workflow:
A Sponsored Products campaign has a full structure underneath it: campaign → ad groups → product ads (your ASINs/SKUs) → keywords (AUTO or MANUAL targeting) → product/category targets → negative keywords. You can build all of it in one conversation or add to an existing campaign later.

​
Example Prompts

​
Check Performance

Amazon campaign metrics with ACOS and ROAS.

Open in Cursor

​
Create a Sponsored Products Campaign

Sponsored Products campaign by ASIN with keyword research.

Open in Cursor

​
Find Wasted Spend

ACOS-based wasted spend analysis with negative keyword suggestions.

Open in Cursor

​
Launch a Sponsored Brands Campaign

Sponsored Brands productCollection campaign with brand logo.

Open in Cursor

​
ACOS, ROAS, and Amazon-Native Metrics

Amazon reporting uses retail-specific metrics that differ from other ad platforms. Adspirer surfaces them directly:
  • Impressions, clicks, CTR, spend — standard delivery metrics
  • Purchases and sales — units ordered and attributed revenue
  • ACOS (advertising cost of sales) — ad spend ÷ attributed sales, expressed as a percentage. Lower is better. ACOS is the metric most Amazon advertisers optimize toward.
  • ROAS (return on ad spend) — attributed sales ÷ ad spend. ROAS is the inverse of ACOS: higher is better.
  • Per-ASIN / per-SKU performance — see which products your ads are actually selling, not just campaign totals
  • Cross-sell / purchased products — what shoppers bought after clicking, even if it wasn’t the advertised ASIN
The key difference from Google, Meta, TikTok, and LinkedIn: Amazon attributes sales of your actual products, so ACOS and ROAS are tied to real retail revenue rather than off-platform conversion events. Use get_amazon_campaign_performance for the rollup, get_amazon_product_performance for the per-ASIN view, and get_amazon_purchased_products for the cross-sell view.

​
Reporting is asynchronous

Amazon Reporting v3 generates reports asynchronously. Adspirer requests a report, then polls Amazon until it’s ready, and get_amazon_report retrieves it by report_id once complete. For large date ranges, a report may still be processing when first requested — ask the assistant to check again in a moment, or pass the report_id to get_amazon_report.
Analytics now serve instantly. Adspirer keeps a nightly-refreshed analytics store of your Amazon performance, so the deeper analytics tools — wasted-spend detection, budget optimization, per-ASIN and purchased-products views, and targeting analysis — return immediately instead of waiting on a live Amazon report to generate. Point-in-time reports (get_amazon_report) still fetch fresh from Amazon when you need the very latest numbers.
Sponsored Brands campaigns require Amazon Brand Registry. Sellers supply a brand entity ID during creation — read yours with list_amazon_brands — and productCollection ads require a brand logo asset. Upload one with upload_amazon_asset (or reference an existing asset with search_amazon_assets) before creating the ad. If your brand isn’t enrolled in Brand Registry, you can still run Sponsored Products and Sponsored Display campaigns.
Sponsored Brands supports all 7 ad types — productCollection, video, brandVideo, storeSpotlight, autoCollection, manualCollection, and productCollectionExtended — plus a full creative asset pipeline and keyword, target, and theme management.

​
Finding your brand entity ID

Sellers need a brandEntityId to create a Sponsored Brands campaign, including SB video, and to register a creative asset. list_amazon_brands returns every Brand Registry entity on the profile with its brandEntityId, its brandId, and its registered name.

Read the brand entity IDs on your Amazon profile.

Open in Cursor
Pass the brandEntityId — the long value beginning ENTITY — not the shorter brandId beside it. Each advertiser profile has its own, so a brand you sell under in more than one marketplace has a different ID per profile: ask against the profile you are about to advertise on. Vendor accounts can usually omit the field entirely.

​
Updates, Budgets, and Failures

  • Budget usage defaults to every enabled campaign. get_amazon_budget_usage no longer needs campaign IDs. Ask “which campaigns are running out of budget?” and it checks all enabled Sponsored Products campaigns on the profile, and says so.
  • Budget updates take either shape. Sponsored Products and Sponsored Brands expect different budget formats, and the assistant used to send the wrong one. update_amazon_campaigns now converts, and keeps a lifetime budget type.
  • Pausing a batch with ended campaigns works. An ended campaign is already not spending, so pausing it counts as done and no longer fails the batch. Resuming an ended campaign is still an error.
  • Partial failures are loud. A change where some items failed leads with “N of M failed”. A change where every item failed comes back as an error, so your assistant can’t report it as done.
  • UK profiles can create Sponsored Display campaigns. Amazon reports the UK as UK on profiles but expects GB on campaigns; Adspirer now translates it. create_amazon_sd_campaign failed on every UK profile before.
  • Campaign lists don’t claim “(0)” when a list failed. Amazon caps Sponsored Products and Brands lists at 100 per page, so max_results tops out at 100 and you page with next_token. A section that couldn’t load says why instead of showing an empty count.
  • Sponsored Brands creates find your brand. If you don’t pass brand_entity_id, create_amazon_sb_campaign uses the profile’s brand when it has exactly one. With several brands, it returns the list and asks you to choose. Ads are submitted in batches of 10, Amazon’s limit. Keyword recommendations need asins or landing_page_url.
  • Video uploads report their real state. upload_amazon_asset sends the correct content type for video, waits briefly for the asset to become ACTIVE (or says it is still PROCESSING), and, for Sponsored Brands video, states which spec check failed and by how much.
  • Amazon tool names sent to the wrong platform are redirected. If an Amazon tool name reaches the Google or Meta tools, the reply points to the amazon_ads router instead of suggesting Google tools.

​
Best Use Cases for Amazon Ads

  • Product launches: Drive visibility for new ASINs that have no organic ranking yet
  • Category capture: Show up when shoppers search for your product category (high purchase intent)
  • Brand defense and conquest: Protect your branded search and target competitor products with Sponsored Display
  • Best-seller scaling: Pour budget into proven ASINs with strong ACOS to grow share
  • Cross-sell and catalog depth: Use purchased-products data to find which products to advertise together
Not ideal for: B2B lead generation (use LinkedIn Ads), products sold off Amazon or on your own store (use Google Ads or Meta Ads), brand awareness to a younger consumer audience (use TikTok Ads).

​
Troubleshooting

​
”Amazon account not connected” error

Re-authenticate with Login with Amazon:
If you manage multiple advertiser profiles, confirm the right one is active. List them with list_amazon_profiles and ask the assistant to switch to the correct profile_id (and region) before creating or pulling data.

​
”Brand Registry required” error on Sponsored Brands

Sponsored Brands campaigns need an enrolled brand. Make sure your brand is in Amazon Brand Registry and that you’ve supplied the brand entity ID — run list_amazon_brands to read it off the profile. If it returns nothing, the brand is enrolled under a different profile: pass that profile_id and ask again. For productCollection ads, upload a brand logo with upload_amazon_asset first. If you don’t have Brand Registry, run Sponsored Products or Sponsored Display instead.

​
”Report still processing” / no report data yet

Amazon reports are asynchronous (Reporting v3). The report is requested, then polled until Amazon finishes generating it. If a report isn’t ready on the first try, wait a moment and retrieve it again with get_amazon_report using the report_id. Large date ranges take longer to generate.

​
Campaign created but not spending

This is expected. Adspirer creates every Amazon campaign PAUSED because campaigns run against production (there’s no Amazon sandbox). Review the campaign, then ask the assistant to resume it with resume_amazon_campaigns. If you’re using agent skills, the AI enforces the correct workflow automatically.

​
FAQ

Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: $49/mo for 150 calls. Pro: $99/mo for 600 calls. Max: $199/mo for 3,000 calls. A typical Sponsored Products campaign creation uses a handful of tool calls (profiles, recommendations, create). See full pricing.
Yes. On connect, Adspirer discovers your advertiser profiles across all three Amazon regions — North America (NA), Europe (EU), and Far East (FE) — and routes requests to the correct region automatically. Each profile is imported as a separate ad account. Use list_amazon_profiles to see them and target a specific one by its profile_id.
Sponsored Products (SP): Keyword- and product-targeted ads that promote individual listings in search results and on product pages. The workhorse of Amazon advertising. No Brand Registry required.Sponsored Brands (SB): Brand-building ads (logo, custom headline, multiple products, or video) shown in prominent placements. Requires Amazon Brand Registry and supports all 7 ad types.Sponsored Display (SD): Audience and contextual targeting (audiences-remarketing plus contextual) shown on and off Amazon — strong for retargeting and competitor-product placements.
Only for Sponsored Brands. Sponsored Products and Sponsored Display work without it. To run Sponsored Brands, enroll your brand in Brand Registry, supply the brand entity ID (list_amazon_brands reads it for you), and upload a brand logo with upload_amazon_asset for productCollection ads.
No. There is no Amazon sandbox, so campaigns run against production. Adspirer creates everything PAUSED so you can review it first. When you’re ready, ask the assistant to resume the campaign with resume_amazon_campaigns.
Yes. Adspirer connects via OAuth through Login with Amazon — your Amazon credentials are never stored client-side. Tokens refresh server-side, and all connections are HTTPS-encrypted. You can revoke access at any time from your Amazon account’s connected-apps settings.
Last modified on October 27, 2026