Skip to main content
DataDoe HubHub
(opens in a new tab)
ChatGPT (opens in a new tab)
Claude (opens in a new tab)

What are Amazon Ads Actions for KDP authors?

KDP authors connect an Amazon Ads profile whose account subtype is KDP_AUTHOR. DataDoe reads the subtype from Amazon when the connection is added or reauthorized, and reads it again once it is more than a week old. An Ads-only account is not treated as an author account unless Amazon reports this subtype.

This page lists the Action types made for authors and the rules other Amazon Ads Actions follow for author accounts. See Actions for how to enable and run Actions, and for the other Amazon Ads Action types. To estimate author earnings from your ads, upload KDP royalty parameters.

You are responsible for the results of Actions you run. Review every payload before running an Action.

Which Action types are made for KDP authors?

R in brackets means read operations.

The four Action types marked KDP beta are in private beta. They are useful for authors but also work for sellers and vendors with the matching Amazon access.

Action typeAction descriptionAction Result dataMax. items (API/MCP)
AMAZON_ADS_PROGRAM_ELIGIBILITY_FIND
(R, KDP beta)		Check which ad programs the Ads profile and, optionally, books can useEligibility and reasons per program.1/1
AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND
(R, KDP beta)		Find Amazon Attribution publishersPublisher IDs and names.1/1
AMAZON_ADS_SB_HEADLINE_RECOMMENDATIONS_FIND
(R, KDP beta)		Find Sponsored Brands headline suggestions for productsSuggested headlines per item.50/20
AMAZON_ADS_SB_INSIGHTS_FIND
(R, KDP beta)		Find keyword insights for planned Sponsored Brands ad groupsImpression share, rank and alerts.1/1
  • AMAZON_ADS_PROGRAM_ELIGIBILITY_FIND returns, for each ad program (SB, SD, MAAS, DTC, SPOT), whether the profile is eligible and why not. Sponsored Products is the baseline program and is not listed. Billing checks run by default; set programs.skipAllBillingChecks to true to skip them. Add products with adType (sp, sb, or sd) and up to 50 asins to check books as well. Eligibility does not guarantee delivery.
  • AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND lists Amazon Attribution publishers. It needs a profile with Amazon Attribution access. Other profiles, including KDP author profiles, get an Amazon authorization error.
  • AMAZON_ADS_SB_HEADLINE_RECOMMENDATIONS_FIND asks Amazon for headline ideas for up to 10 ASINs per item. Titles of collection ads are limited to 32 characters, so check the length before you use one.
  • AMAZON_ADS_SB_INSIGHTS_FIND rates planned keywords and bids for Sponsored Brands ad groups before launch: search term impression share and rank, and LOW_KEYWORD_TRAFFIC or LOW_BID alerts. It does not report campaign performance; use data tables for that.

How do other Amazon Ads Actions work for KDP author accounts?

For KDP author accounts, existing Ads Actions apply these rules:

  • AMAZON_ADS_CAMPAIGNS_ADD for SPONSORED_BRANDS does not send goal or smartDefault, because Amazon sets them for authors. smartDefault: "TARGETING" is rejected. brandId must be an author brand: use AMAZON_ADS_BRANDS_FIND with brandTypeFilter: "bookAuthor" and send its brandEntityId.
  • AMAZON_ADS_BRANDS_FIND without brandTypeFilter returns author brands.
  • AMAZON_ADS_ADS_ADD for a Sponsored Brands product collection needs at least 3 unique product ASINs and a headline of at most 32 characters, and does not accept customImages. Amazon creates these ads as Manual Collection ads.
  • AMAZON_ADS_CAMPAIGNS_REMOVE and the other remove Actions archive entities; archiving cannot be undone.
  • Search term text in targets is not a target ID; use AMAZON_ADS_TARGETS_FIND to look up IDs.
  • Bid, keyword, and budget recommendations and budget rules optimize Amazon's reported ad sales, not author royalties.