Skip to content

Kuudo

Search Kuudo

Loading search…

<- All docs

MCP Reference

Amazon Ads API Tools

The Amazon Ads API is Amazon's REST API for managing advertising: campaigns, DSP, Amazon Marketing Cloud and reports. Here is each operation as an AI tool.

Updated Oct 7, 2026 4 min read

The Amazon Ads API is how advertisers and Amazon Ads partners manage advertising programmatically: Sponsored Products, Sponsored Brands, Sponsored Display, Amazon DSP (demand-side platform), Amazon Marketing Cloud (AMC), audiences and reporting. It is separate from the Selling Partner API, with its own developer access and its own Login with Amazon authorization, scoped to advertising profiles. Amazon documents it at advertising.amazon.com/API/docs.

You normally call it through an app approved for Amazon Ads API access. On Kuudo Pro and Kuudo Scale, your agent uses Kuudo's managed, verified Amazon Ads app instead: see Amazon account authorization.

This page lists every tool the Amazon Ads MCP exposes, grouped by the underlying Amazon Ads API resource. Each entry shows whether it's a read tool (safe to call freely) or a write tool (guarded, may require approval), the tool name, and a short description. See Kuudo MCP Servers for the full index of Kuudo MCP servers.

The server's creative operations sit beside Amazon Agent Iris generation for Amazon Ads images and video. Iris creates the destination-specific assets; the Amazon Ads MCP registers creative assets and runs the supported ad, creative, and campaign operations against the authorized account.

Expand any resource below to see its tools. Your browser's find-in-page (Ctrl+F / Cmd+F) searches across every tool on this page, even inside collapsed sections.

Amazon Marketing Cloud API tools

Kuudo exposes Amazon Marketing Cloud API operations as callable MCP tools across four resource groups: AMC administration, workflows, rule-based audiences, and ad-based audiences. Use this page for Kuudo tool names and access modes; use Amazon's official documentation for canonical API schemas and policies.

Kuudo's Amazon Marketing Cloud software packages these operations into governed workflows, while the Amazon Ads MCP page explains the broader server.

All Amazon Ads MCP tools

55 resources with tools · 756 tools
AccountsAccountBudgets 2 tools
read
ac_getAccountBudgetFeatureFlags

Gets account budget feature flags information.

write
ac_updateAccountBudgetFeatureFlags

Creates or Updates account budget feature flags information.

AccountsAdsAccounts 5 tools
write
ac_RegisterAdsAccount

Create a new advertising account tied to a specific Amazon vendor, seller or author, or to a business who does not sell on Amazon.

read
ac_ListAdsAccounts

List all advertising accounts for the user associated with the access token.

read
ac_GetAccount

Request attributes of a given advertising account.

write
ac_CreateTermsToken

Create a new UUID terms token for the customer to accept advertising terms Requires one of these permissions: []

read
ac_GetTermsToken

Get the terms token status for the customer Requires one of these permissions: []

AccountsBilling 19 tools
read
ac_GetDocument

Gets billing document(s) with id.

write
ac_PayInvoices

Executes payment on a set of or all of an advertisers open invoices.

write
ac_bulkGetBillingNotifications

Gets an array of all currently valid billing notifications associated for each advertising account.

write
ac_CreatePaymentAgreements

Creates or updates payment agreements.

read
ac_GetPaymentAgreements

Gets current payment agreement for a customer.

read
ac_GetCustomerPaymentMethods

Retrieves eligible payment methods for a customer.

write
ac_CreatePaymentProfiles

Creates or updates payment profiles.

write
ac_bulkGetBillingStatus

Gets the current billing status associated for each advertising account.

read
ac_GetBillingProfileAgreementContent

User needs to provide consent to certain agreements before creating a billing profile.

write
ac_ApplyBillingProfile

API to link one or more countries with a billing profile.

read
ac_GetBillingProfileUsages

Lists the billing profiles linked to each country of global ads account.

write
ac_CreateBillingProfiles

Creates one or more billing profiles.

write
ac_UpdateBillingProfiles

Updates one or more billing profiles under a global account Please note that isBillTo and type are immutable attributes and cannot be updated -- in this case, user can always create a new billing...

read
ac_GetBillingProfiles

Fetches billing profiles present under the global account.

write
ac_CreateBillingStatement

Request to create billing statement for advertiser advertising in Sponsored Products/Brands/Display segment.

read
ac_GetBillingStatement

API to fetch the latest status of Billing Statements creation request and billing statement download link if available.

read
ac_GetBillingInvoiceSummaries

Lists the billing invoice summary(s) in a global ads account.

read
ac_getAdvertiserInvoices

Requires one of these permissions: ["nemo_transactions_view","nemo_transactions_edit"]

read
ac_getInvoice

Requires one of these permissions: ["nemo_transactions_view","nemo_transactions_edit"]

AccountsManagerAccounts 4 tools
read
ac_getManagerAccountsForUser

Returns all manager accounts that a user has access to, along with metadata for the Amazon Ads accounts t...

write
ac_createManagerAccount

Creates a new Amazon Advertising Manager account.

write
ac_LinkAdvertisingAccountsToManagerAccountPublicAPI

Link Amazon Advertising accounts or advertisers with a Manager Account.

write
ac_UnlinkAdvertisingAccountsToManagerAccountPublicAPI

Unlink Amazon Advertising accounts or advertisers with a Manager Account.

AccountsPortfolios 4 tools
write
ac_CreatePortfolios

Requires one of these permissions: ["advertiser_campaign_edit"]

write
ac_UpdatePortfolios

Requires one of these permissions: ["advertiser_campaign_edit"]

write
ac_portfolioBudgetUsage

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
ac_ListPortfolios

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

AccountsProfiles 3 tools
read
ac_listProfiles

Note that this operation does not return a response unless the current account has created at least one campaign using the advertising console.

write
ac_updateProfiles

Note that this operation is only used for Sellers using Sponsored Products.

read
ac_getProfileById

This operation does not return a response unless the current account has created at least one campaign using the advertising console.

AdLibraryAPI 2 tools
read
adlib_ListAds

This is the primary paginated API for retrieving, listing, and searching through the ad repository.

read
adlib_GetAdsByID

This is the API for retrieving a single advertisement metadata specified by its id from the ad repository.

AdsAPIv1All 131 tools
read
allv1_ListBrandStoreEdition

Retrieve brand store page content Requires one of these permissions: ["amazon_stores_edit","amazon_stores_view"]

read
allv1_ListBuyerSeat

List buyer seats Requires one of these permissions: ["campaign_view"]

read
allv1_ListCommitment

List commitments Requires one of these permissions: []

write
allv1_CreateAccountCombinationInvitation

Create an invitation to combine Advertising Accounts under a Single Global Accou...

write
allv1_CreateAccountLinkInvite

Create an AccountLinkInvite Requires one of these permissions: ["manage_use...

write
allv1_CreateAdAssociation

Create Ad Association Note: Batch size limits are specific to each ad produ...

write
allv1_CreateAdExtension

Create ad extensions - API is in open beta Note: Batch size limits are spec...

write
allv1_CreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
allv1_CreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
allv1_CreateAdvertiserAccount

Create advertiser accounts Requires one of these permissions: []

write
allv1_CreateAdvertiserProductGroupEligibility

Create request for specific advertiser product group eligibility Requires one...

write
allv1_SBCreateAdvertisingDealTarget

Create advertisingDealTarget Requires one of these permissions: ["advertise...

write
allv1_CreateAdvertisingDeal

Create advertising deals Requires one of these permissions: ["inventory_edit", "inventory_view"]

write
allv1_SBCreateAdvertisingDeal

Create advertisingDeal Requires one of these permissions: ["advertiser_campaign_edit", "advertiser_campaign_view"]

write
allv1_SBCreateBrandedKeywordsPricing

Create brandedKeywords pricing Requires one of these permissions: ["adverti...

write
allv1_CreateBuyerSeat

Create buyer seats for advertisers Requires one of these permissions: ["campaign_view"]

write
allv1_CreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
allv1_CreateCommitment

Create commitments Requires one of these permissions: []

write
allv1_CreateCommunicationContact

Creates a communication contact for the authenticated advertiser, binding a cont...

write
allv1_CreateDealAdvertiserAccessEntry

Add advertisers to a deal advertiser access list Requires one of these permissions: ["inventory_edit"]

write
allv1_CreateDealAdvertiserAccess

Create a deal advertiser access record with a strategy (ALLOW or BLOCK) Requi...

write
allv1_CreateDealPreference

Creates one or more deal preferences for a DSP advertiser account.

write
allv1_CreateEvent

Create Event Data Requires one of these permissions: ["event_manager_view",...

write
allv1_CreateGeoLocation

Create geo location targeting definitions.

write
allv1_AdsApiv1CreateInventoryGroup

Create inventory groups Requires one of these permissions: ["inventory_edit"]

write
allv1_SBCreateKeywordReservationValidation

Validate keyword reservation Requires one of these permissions: ["advertise...

write
allv1_CreateLinearTvIncrementalReachForecast

Generate Linear TV incremental reach forecast comparing with supported Streaming...

write
allv1_CreateLinearTvReachForecast

Generate Linear TV reach forecast Requires one of these permissions: ["campaign_edit"]

write
allv1_CreateLocationIndex

Create a Smart Location Index.

write
allv1_CreateManagerAccount

Create manager accounts Requires one of these permissions: []

write
allv1_CreatePromotionCodeRedemption

API to create promotion code redemptions for affiliate codes Requires one of...

write
allv1_SBCreateRecommendation

Create recommendations Requires one of these permissions: ["advertiser_campaign_view"]

write
allv1_AdsApiv1CreateReport

Create a report Requires one of these permissions: ["ManagerAccount_Dev", "...

write
allv1_SBAdsApiv1CreateReservedTargetPricing

Create reservedTarget pricing Requires one of these permissions: ["advertis...

write
allv1_AdsApiv1CreateStreamSubscription

Create a new subscription\nNote: trailing slash in request uri is not allowed ...

write
allv1_CreateSupplierAdProductPrice

Create supplier ad product price Requires one of these permissions: ["inventory_view"]

write
allv1_CreateSupplierProposal

Create supplier proposal Requires one of these permissions: ["inventory_edit"]

write
allv1_CreateSupplierProposedDealForecast

Create supplier proposed deal forecast Requires one of these permissions: ["inventory_edit"]

write
allv1_CreateSupplierProposedDealRevision

Create supplier proposed deal revision Requires one of these permissions: ["inventory_edit"]

write
allv1_CreateSupplierProposedDeal

Create supplier proposed deal Requires one of these permissions: ["inventory_edit"]

write
allv1_CreateTarget

Create target Note: Batch size limits are specific to each ad product.

read
allv1_ListDealPerformance

Retrieve performance metrics for each specified deal.

read
allv1_ListDealPreference

Lists deal preferences for a DSP advertiser account.

write
allv1_DeleteAccountLinkInvite

Delete an AccountLinkInvite Requires one of these permissions: ["manage_use...

write
allv1_DeleteAccountLink

Delete Account Links for a given advertising account Requires one of these pe...

write
allv1_DeleteAdAssociation

Delete Ad Association Note: Batch size limits are specific to each ad produ...

write
allv1_DeleteAdGroup

Delete ad groups Note: Batch size limits are specific to each ad product.

write
allv1_DeleteAd

Delete ads Note: Batch size limits are specific to each ad product.

write
allv1_SBDeleteAdvertisingDealTarget

Delete advertisingDealTarget Requires one of these permissions: ["advertise...

write
allv1_SBDeleteAdvertisingDeal

Delete advertisingDeal Requires one of these permissions: ["advertiser_campaign_edit", "advertiser_campaign_view"]

write
allv1_DeleteCampaign

Delete campaigns Note: Batch size limits are specific to each ad product.

write
allv1_DeleteDealAdvertiserAccessEntry

Remove advertisers from a deal advertiser access list Requires one of these permissions: ["inventory_edit"]

write
allv1_DeleteDealAdvertiserAccess

Delete a deal advertiser access record and all associated entries Requires on...

write
allv1_AdsApiv1DeleteReport

Delete a report by ID Requires one of these permissions: []

write
allv1_AdsApiv1DeleteStreamSubscription

Archive an existing subscription Note: trailing slash in request uri is not allo...

write
allv1_DeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
allv1_ListLocationIndex

List all Smart Location Indexes for the authenticated advertiser.

read
allv1_QueryAccountCombinationInvitation

Query invitations to combine advertising accounts under a Single Global Account.

read
allv1_QueryAccountLinkInvite

Query AccountLinkInvites for an account Requires one of these permissions:...

read
allv1_QueryAccountLink

Query Account Links for a given advertising account Requires one of these per...

read
allv1_QueryAdAssociation

Query Ad Association Note: Batch size limits are specific to each ad produc...

read
allv1_QueryAdExtension

Query ad_extension - API is in open beta Note: Batch size limits are specif...

read
allv1_QueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
allv1_QueryAd

List ads Note: Batch size limits are specific to each ad product.

read
allv1_QueryAdvertiserAccount

List advertiser accounts Requires one of these permissions: []

read
allv1_QueryAdvertiserProductGroupEligibility

Query requests for specific advertiser product group eligibility based on advert...

read
allv1_SBQueryAdvertisingDealTarget

Query advertisingDealTarget Requires one of these permissions: ["advertiser...

read
allv1_QueryAdvertisingDeal

Query advertising deals with filters Requires one of these permissions: ["inventory_edit", "inventory_view"]

read
allv1_SBQueryAdvertisingDeal

Query advertisingDeal Requires one of these permissions: ["advertiser_campaign_edit", "advertiser_campaign_view"]

read
allv1_QueryBrandStoreEditionPublishVersion

Query store edition publish versions Requires one of these permissions: ["amazon_stores_edit","amazon_stores_view"]

read
allv1_QueryBrandStorePage

Retrieve brand store page content Requires one of these permissions: ["amazon_stores_edit","amazon_stores_view"]

read
allv1_QueryBrandStore

Query brand store content Requires one of these permissions: ["advertiser_c...

read
allv1_QueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
allv1_QueryCommitment

Query commitments with filters Requires one of these permissions: []

read
allv1_QueryCommunicationContact

Returns communication contacts for the authenticated advertiser, optionally filt...

read
allv1_QueryCommunicationPreference

Returns communication preferences for the authenticated advertiser, optionally f...

read
allv1_QueryDealAdvertiserAccessEntry

Query advertiser entries for a deal advertiser access record Requires one of...

read
allv1_QueryDealAvails

Query deal avails by advertising deal ID.

read
allv1_QueryDealPlanningMetrics

Query deal planning metrics for specified deals, with optional metric range filt...

read
allv1_AdsApiv1QueryInventoryGroup

Query inventory groups with filters Requires one of these permissions: ["inventory_edit", "inventory_view"]

read
allv1_QueryLabelObjectAssociation

Query label-to-object associations with filters.

read
allv1_QueryLabel

Query labels with filters.

read
allv1_QueryLinearTvDaypart

List all supported Linear TV Daypart Requires one of these permissions: []

read
allv1_QueryManagerAccount

List manager accounts Requires one of these permissions: []

read
allv1_QueryPromotionOffer

API to list the promotion offers for a global account Requires one of these p...

read
allv1_QueryPromotionReward

Query promotion rewards for an advertiser account.

read
allv1_QueryPublisher

Query publishers.

read
allv1_SBQueryRecommendationType

Query RecommendationTypes Requires one of these permissions: ["advertiser_campaign_view"]

read
allv1_QueryRecommendation

Fetch full recommendations for a given advertiser and product.

read
allv1_QuerySeller

Query sellers.

read
allv1_QuerySellingAccount

List selling accounts Requires one of these permissions: []

read
allv1_AdsApiv1QueryStreamSubscription

Query subscriptions Note: trailing slash in request uri is not allowed Requir...

read
allv1_QuerySupplierAdProduct

Query supplier ad products Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplierProposalDestination

Query supplier proposal destinations Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplierProposal

Query supplier proposal Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplierProposedDealHistoricalVersion

Query supplier proposed deal historical versions Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplierProposedDeal

Query supplier proposed deals Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplierPublisher

Query supplier publishers Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplierTargetItem

Fetch supplier target items Requires one of these permissions: ["inventory_view"]

read
allv1_QuerySupplier

Query suppliers.

read
allv1_QueryTarget

List target Note: Batch size limits are specific to each ad product.

read
allv1_ListRecommendation

List recommendations for a given advertiser.

write
allv1_DSPRetrieveCampaignForecast

Retrieve campaign forecast Requires one of these permissions: ["campaign_view", "advertiser_campaign_view"]

read
allv1_RetrieveCommitmentSpend

Retrieve commitment spend Requires one of these permissions: []

read
allv1_RetrieveCommitment

Get Commitments Requires one of these permissions: []

read
allv1_RetrieveDealAdvertiserAccess

Retrieve a deal advertiser access record by ID Requires one of these permissi...

read
allv1_RetrieveLocationIndex

Retrieve one or more Smart Location Indexes by ID.

write
allv1_AdsApiv1RetrieveReport

Retrieve a report by ID Requires one of these permissions: []

write
allv1_AdsApiv1RetrieveStreamSubscription

Fetch a specific subscription by Id Note: trailing slash in request uri is not a...

write
allv1_UpdateAccountCombinationInvitation

Update an invitation to combine Advertising Accounts under a Single Global Accou...

write
allv1_UpdateAccountLinkInvite

Update an AccountLinkInvite Requires one of these permissions: ["manage_use...

write
allv1_UpdateAccountLink

Update Account Links for a given advertising account Requires one of these pe...

write
allv1_UpdateAdAssociation

Update Ad Association Note: Batch size limits are specific to each ad produ...

write
allv1_UpdateAdExtension

Update ad_extension - API is in open beta Note: Batch size limits are speci...

write
allv1_UpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
allv1_UpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
allv1_UpdateAdvertiserAccount

Update advertiser accounts Requires one of these permissions: []

write
allv1_UpdateAdvertisingDeal

Update advertising deals Requires one of these permissions: ["inventory_edit", "inventory_view"]

write
allv1_SBUpdateAdvertisingDeal

Update advertisingDeal Requires one of these permissions: ["advertiser_campaign_edit", "advertiser_campaign_view"]

write
allv1_UpdateBrandStoreEditionPublishVersion

Update store edition publish versions Requires one of these permissions: ["amazon_stores_edit"]

write
allv1_UpdateBrandStorePage

Update brand store page content Requires one of these permissions: ["amazon_stores_edit"]

write
allv1_UpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

write
allv1_UpdateCommitment

Update commitments Requires one of these permissions: []

write
allv1_UpdateCommunicationPreference

Updates communication preferences for the authenticated advertiser.

write
allv1_AdsApiv1UpdateInventoryGroup

Update inventory groups Requires one of these permissions: ["inventory_edit"]

write
allv1_UpdateLocationIndex

Update the data for an existing Smart Location Index.

write
allv1_UpdateManagerAccount

Update manager accounts Requires one of these permissions: []

write
allv1_UpdateSupplierProposal

Update supplier proposal Requires one of these permissions: ["inventory_edit"]

write
allv1_UpdateSupplierProposedDealRevision

Update supplier proposed deal revision Requires one of these permissions: ["inventory_edit"]

write
allv1_UpdateSupplierProposedDeal

Update supplier proposed deal Requires one of these permissions: ["inventory_edit"]

write
allv1_UpdateTarget

Update target Note: Batch size limits are specific to each ad product.

AdsAPIv1Beta 27 tools
write
beta_CreateAccountCombinationInvitation

Create an invitation to combine Advertising Accounts under a Single Global Accou...

write
beta_CreateAccountLinkInvite

Create an AccountLinkInvite Requires one of these permissions: ["manage_use...

write
beta_CreateAdvertiserProductGroupEligibility

Create request for specific advertiser product group eligibility Requires one...

write
beta_CreateCommunicationContact

Creates a communication contact for the authenticated advertiser, binding a cont...

write
beta_CreateEvent

Create Event Data Requires one of these permissions: ["event_manager_view",...

write
beta_AdsApiv1CreateInventoryGroup

Create inventory groups Requires one of these permissions: ["inventory_edit"]

write
beta_CreateLinearTvIncrementalReachForecast

Generate Linear TV incremental reach forecast comparing with supported Streaming...

write
beta_CreateLinearTvReachForecast

Generate Linear TV reach forecast Requires one of these permissions: ["campaign_edit"]

write
beta_CreatePromotionCodeRedemption

API to create promotion code redemptions for affiliate codes Requires one of...

write
beta_DeleteAccountLinkInvite

Delete an AccountLinkInvite Requires one of these permissions: ["manage_use...

write
beta_DeleteAccountLink

Delete Account Links for a given advertising account Requires one of these pe...

read
beta_QueryAccountCombinationInvitation

Query invitations to combine advertising accounts under a Single Global Account.

read
beta_QueryAccountLinkInvite

Query AccountLinkInvites for an account Requires one of these permissions:...

read
beta_QueryAccountLink

Query Account Links for a given advertising account Requires one of these per...

read
beta_QueryAdvertiserProductGroupEligibility

Query requests for specific advertiser product group eligibility based on advert...

read
beta_QueryCommunicationContact

Returns communication contacts for the authenticated advertiser, optionally filt...

read
beta_QueryCommunicationPreference

Returns communication preferences for the authenticated advertiser, optionally f...

read
beta_AdsApiv1QueryInventoryGroup

Query inventory groups with filters Requires one of these permissions: ["inventory_edit", "inventory_view"]

read
beta_QueryLinearTvDaypart

List all supported Linear TV Daypart Requires one of these permissions: []

read
beta_QueryPromotionOffer

API to list the promotion offers for a global account Requires one of these p...

read
beta_QueryPromotionReward

Query promotion rewards for an advertiser account.

write
beta_UpdateAccountCombinationInvitation

Update an invitation to combine Advertising Accounts under a Single Global Accou...

write
beta_UpdateAccountLinkInvite

Update an AccountLinkInvite Requires one of these permissions: ["manage_use...

write
beta_UpdateAccountLink

Update Account Links for a given advertising account Requires one of these pe...

write
beta_UpdateBrandStorePage

Update brand store page content Requires one of these permissions: ["amazon_stores_edit"]

write
beta_UpdateCommunicationPreference

Updates communication preferences for the authenticated advertiser.

write
beta_AdsApiv1UpdateInventoryGroup

Update inventory groups Requires one of these permissions: ["inventory_edit"]

AdsAPIv1DSP 16 tools
write
dspv1_DSPCreateAdAssociation

Create Ad Association Note: Batch size limits are specific to each ad product.

write
dspv1_DSPCreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
dspv1_DSPCreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
dspv1_DSPCreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
dspv1_DSPCreateTarget

Create target Note: Batch size limits are specific to each ad product.

write
dspv1_DSPDeleteAdAssociation

Delete Ad Association Note: Batch size limits are specific to each ad product.

write
dspv1_DSPDeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
dspv1_DSPQueryAdAssociation

Query Ad Association Note: Batch size limits are specific to each ad product.

read
dspv1_DSPQueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
dspv1_DSPQueryAd

List ads Note: Batch size limits are specific to each ad product.

read
dspv1_DSPQueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
dspv1_DSPQueryTarget

List target Note: Batch size limits are specific to each ad product.

write
dspv1_DSPUpdateAdAssociation

Update Ad Association Note: Batch size limits are specific to each ad product.

write
dspv1_DSPUpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
dspv1_DSPUpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
dspv1_DSPUpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

AdsAPIv1SponsoredBrands 19 tools
write
sbv1_SBCreateAdExtension

Create ad extensions - API is in open beta Note: Batch size limits are specific to each ad product.

write
sbv1_SBCreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
sbv1_SBCreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
sbv1_SBCreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
sbv1_SBCreateTarget

Create target Note: Batch size limits are specific to each ad product.

write
sbv1_SBDeleteAdGroup

Delete ad groups Note: Batch size limits are specific to each ad product.

write
sbv1_SBDeleteAd

Delete ads Note: Batch size limits are specific to each ad product.

write
sbv1_SBDeleteCampaign

Delete campaigns Note: Batch size limits are specific to each ad product.

write
sbv1_SBDeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
sbv1_SBQueryAdExtension

Query ad_extension - API is in open beta Note: Batch size limits are specific to each ad product.

read
sbv1_SBQueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
sbv1_SBQueryAd

List ads Note: Batch size limits are specific to each ad product.

read
sbv1_SBQueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
sbv1_SBQueryTarget

List target Note: Batch size limits are specific to each ad product.

write
sbv1_SBUpdateAdExtension

Update ad_extension - API is in open beta Note: Batch size limits are specific to each ad product.

write
sbv1_SBUpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
sbv1_SBUpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
sbv1_SBUpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

write
sbv1_SBUpdateTarget

Update target Note: Batch size limits are specific to each ad product.

AdsAPIv1SponsoredDisplay 16 tools
write
sdv1_SDCreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
sdv1_SDCreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
sdv1_SDCreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
sdv1_SDCreateTarget

Create target Note: Batch size limits are specific to each ad product.

write
sdv1_SDDeleteAdGroup

Delete ad groups Note: Batch size limits are specific to each ad product.

write
sdv1_SDDeleteAd

Delete ads Note: Batch size limits are specific to each ad product.

write
sdv1_SDDeleteCampaign

Delete campaigns Note: Batch size limits are specific to each ad product.

write
sdv1_SDDeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
sdv1_SDQueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
sdv1_SDQueryAd

List ads Note: Batch size limits are specific to each ad product.

read
sdv1_SDQueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
sdv1_SDQueryTarget

List target Note: Batch size limits are specific to each ad product.

write
sdv1_SDUpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
sdv1_SDUpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
sdv1_SDUpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

write
sdv1_SDUpdateTarget

Update target Note: Batch size limits are specific to each ad product.

AdsAPIv1SponsoredProducts 19 tools
write
spv1_SPCreateAdExtension

Create ad extensions - API is in open beta Note: Batch size limits are specific to each ad product.

write
spv1_SPCreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
spv1_SPCreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
spv1_SPCreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
spv1_SPCreateTarget

Create target Note: Batch size limits are specific to each ad product.

write
spv1_SPDeleteAdGroup

Delete ad groups Note: Batch size limits are specific to each ad product.

write
spv1_SPDeleteAd

Delete ads Note: Batch size limits are specific to each ad product.

write
spv1_SPDeleteCampaign

Delete campaigns Note: Batch size limits are specific to each ad product.

write
spv1_SPDeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
spv1_SPQueryAdExtension

Query ad_extension - API is in open beta Note: Batch size limits are specific to each ad product.

read
spv1_SPQueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
spv1_SPQueryAd

List ads Note: Batch size limits are specific to each ad product.

read
spv1_SPQueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
spv1_SPQueryTarget

List target Note: Batch size limits are specific to each ad product.

write
spv1_SPUpdateAdExtension

Update ad_extension - API is in open beta Note: Batch size limits are specific to each ad product.

write
spv1_SPUpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
spv1_SPUpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
spv1_SPUpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

write
spv1_SPUpdateTarget

Update target Note: Batch size limits are specific to each ad product.

AdsAPIv1SponsoredTelevision 14 tools
write
stv1_STCreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
stv1_STCreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
stv1_STCreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
stv1_STCreateTarget

Create target Note: Batch size limits are specific to each ad product.

write
stv1_STDeleteAd

Delete ads Note: Batch size limits are specific to each ad product.

write
stv1_STDeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
stv1_STQueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
stv1_STQueryAd

List ads Note: Batch size limits are specific to each ad product.

read
stv1_STQueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
stv1_STQueryTarget

List target Note: Batch size limits are specific to each ad product.

write
stv1_STUpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
stv1_STUpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
stv1_STUpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

write
stv1_STUpdateTarget

Update target Note: Batch size limits are specific to each ad product.

AmazonAttribution 5 tools
read
attr_getAdvertisersByProfile

For sellers, an attribution profile has one associated advertiser.

read
attr_getPublishers

Use the response to determine whether to use either the macroTags or nonMacroTemplateTags resource to get tags for a certain publisher.

read
attr_getAttributionTagsByCampaign

Gets an attribution report for a specified list of advertisers.

read
attr_getPublisherAttributionTagTemplate

Third-party publishers, such as Google Ads, Facebook, Microsoft Ads, and Pinterest support tags that include macro parameters.

read
attr_getPublisherMacroAttributionTag

Some third-party publishers do not support tags that include macro parameters.

AmazonDSPAdvertisers 2 tools
read
dsp_getDspAdvertisers

Returns a list of advertisers with information which satisfy the filtering criteria.

read
dsp_getDspAdvertisersByAdvertiserId

Returns advertiser information based on given advertiser id.

AmazonDSPAudiences 1 tools
write
dsp_dspCreateAudiencesPost

Creates a targeting audience based on an audience definition.

AmazonDSPConversions 17 tools
read
dsp_dspAmazonAdTagGetEventsByAdTagId

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

read
dsp_dspAmazonAdTagGetAdTagByAdvertiserId

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

write
dsp_dspAmazonBatchGetConversionDefinitionsForOrders

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["campaign_view"]

write
dsp_dspAmazonCreateConversionDefinitions

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

write
dsp_dspAmazonUpdateConversionDefinitions

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

write
dsp_dspAmazonDeletionRequest

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

write
dsp_dspAmazonIngestConversionData

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manager_edit"]

read
dsp_dspAmazonListConversionDefinitions

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

read
dsp_dspAmazonGetAdTagAssociatedEvent

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

write
dsp_dspAmazonUpdateAdTagAssociatedEvent

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manag...

read
dsp_dspAmazonGetAssociatedMobileAppForConversionDefinition

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manager_view"]

write
dsp_dspAmazonBatchCreateMobileMeasurementPartnerApp

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manager_edit"]

write
dsp_dspAmazonBatchUpdateMobileMeasurementPartnerApp

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manager_edit"]

write
dsp_dspAmazonDeleteMeasurementPartnerAppRegistrations

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manager_edit"]

read
dsp_dspAmazonListMobileMeasurementPartnerAppRegistrations

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["event_manager_view"]

read
dsp_dspAmazonGetAssociatedConversionDefinitionsForOrder

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["campaign_view"]

write
dsp_dspAmazonUpdateAssociatedConversionDefinitionsForOrder

Associate or dissociate conversion definitions for an order, including optional conversion weights (weight-based optimization).

AmazonDSPMeasurement 30 tools
write
dsp_CheckDSPAudienceResearchEligibility

Checks the DSP AUDIENCE_RESEARCH study type eligibility status against vendor products.

write
dsp_CheckDSPBrandLiftEligibility

Checks the DSP BRAND_LIFT study type eligibility status against vendor products.

write
dsp_CheckDSPCreativeTestingEligibility

Checks the DSP CREATIVE_TESTING study type eligibility status against vendor products.

write
dsp_CheckDSPOmnichannelMetricsEligibility

Checks the DSP OMNICHANNEL_METRICS study type eligibility status against vendor products.

read
dsp_GetDSPAudienceResearchStudies

Gets one or more DSP AUDIENCE_RESEARCH studies with requested study identifiers or an advertiser identifier.

write
dsp_CreateDSPAudienceResearchStudy

Create new DSP AUDIENCE_RESEARCH study.

write
dsp_UpdateDSPAudienceResearchStudy

Update DSP AUDIENCE_RESEARCH study.

read
dsp_GetDSPAudienceResearchStudyResult

Get result of a DSP AUDIENCE_RESEARCH study.

read
dsp_GetDSPBrandLiftStudies

Gets one or more DSP BRAND_LIFT studies with requested study identifiers or an advertiser identifier.

write
dsp_CreateDSPBrandLiftStudies

Create new DSP BRAND_LIFT studies.

write
dsp_UpdateDSPBrandLiftStudies

Update DSP BRAND_LIFT studies.

read
dsp_GetDSPCreativeTestingStudies

Gets one or more DSP CREATIVE_TESTING studies with requested study identifiers or an advertiser identifier.

write
dsp_CreateDSPCreativeTestingStudy

Create new DSP CREATIVE_TESTING study.

write
dsp_UpdateDSPCreativeTestingStudy

Update DSP CREATIVE_TESTING study.

read
dsp_GetDSPCreativeTestingStudyResult

Get result of a DSP CREATIVE_TESTING study.

read
dsp_GetDSPOmnichannelMetricsStudies

Gets one or more DSP OMNICHANNEL_METRICS studies with requested study identifiers or an advertiser identifier.

write
dsp_CreateDSPOmnichannelMetricsStudies

Create new DSP OMNICHANNEL_METRICS studies.

write
dsp_UpdateDSPOmnichannelMetricsStudies

Update DSP OMNICHANNEL_METRICS studies.

read
dsp_GetDSPOmnichannelMetricsStudyResult

Get result of a DSP OMNICHANNEL_METRICS study.

write
dsp_CheckPlanningEligibility

Checks eligibility against all vendor products.

write
dsp_CancelMeasurementStudies

Cancel existing studies.

read
dsp_GetStudies

Gets base study objects given a list of studyIds or a list of advertiserIds.

read
dsp_GetDSPBrandLiftStudyResult

Get result of a DSP BRAND_LIFT study.

read
dsp_GetSurveys

Gets one or more study surveys with requested survey identifiers or a study identifier.

write
dsp_CreateSurveys

Create new study surveys.

write
dsp_UpdateSurveys

Update measurement surveys.

read
dsp_vendorProduct

Lists the supported measurement vendors products.

read
dsp_omnichannelMetricsBrandSearch

Search for brands to be used in the OMNICHANNEL_METRICS vendor product.

read
dsp_vendorProductPolicy

Gets the policies for the specific vendor product(s).

read
dsp_vendorProductSurveyQuestionTemplates

Gets the survey question templates for the specific vendor product(s).

AmazonDSPTargetKPIRecommendations 1 tools
read
dsp_getGsbTargetKpiRecommendation

Creates a Target KPI recommendation for advertisers when they are in the process of creating a new campaign (ADSP).

AmazonMarketingStreamSubscriptions 8 tools
read
ams_ListDspStreamSubscriptions

List subscriptions Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-Account-ID Parameter in:…

write
ams_CreateDspStreamSubscription

Create a new subscription Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-Account-ID Parameter…

read
ams_GetDspStreamSubscription

Fetch a specific subscription by Id Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-Acc...

write
ams_UpdateDspStreamSubscription

Update an existing subscription Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-Account-ID…

read
ams_ListStreamSubscriptions

List subscriptions Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in:…

write
ams_CreateStreamSubscription

Create a new subscription Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter…

read
ams_GetStreamSubscription

Fetch a specific subscription by Id Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-Acc...

write
ams_UpdateStreamSubscription

Update an existing subscription Note: trailing slash in request uri is not allowed Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId…

AMCAdAudience 5 tools
write
amc_CreateAudienceMetadataV2

Create a new Advertiser Audience Metadata.

read
amc_GetAudienceMetadataV2

Get an Advertiser Audience Metadata using AudienceId.

write
amc_UpdateAudienceMetadataV2

Update an existing Advertiser Audience Metadata.

write
amc_ManageAudienceV2

Manage Advertiser audiences by adding or removing members from an Audience.

read
amc_ManageAudienceStatusV2

Get the status of a manage audience members request.

AMCAdmin 25 tools
read
amc_AmcpLinkListAmcAccounts

Get a list of AMC Accounts that the user have access to.

read
amc_listInstances

Gets information about all AMC instances that the requesting entity has access to.

write
amc_createInstance

Creates a new AMC instance.

write
amc_deleteInstance

Deletes the requested AMC instance.

read
amc_getInstance

Gets information about the requested AMC instance.

write
amc_updateInstance

Updates the requested AMC instance.

read
amc_getInstanceAdvertisers

Gets advertisers information about the requested AMC instance.

read
amc_listAdvertiserUpdates

Gets advertiser updates for the requested AMC instance.

write
amc_createAdvertiserUpdate

Creates a new advertiser update for the requested AMC instance.

read
amc_getAdvertiserUpdate

Gets the requested advertiser update for the requested AMC instance.

read
amc_getInstanceCollaboration

Gets the collaboration metadata for the requested AMC instance.

write
amc_createCollaborationIdMappingTable

Creates an ID Mapping Table in the requested AMC instance collaboration and starts the job to populate the table.

read
amc_listCollaborationIdMappingTables

Lists the ID mapping tables in the collaboration in the requested AMC instance.

write
amc_deleteCollaborationIdMappingTable

Deletes the given ID Mapping Table in the collaboration for the requested AMC instance.

read
amc_getCollaborationIdMappingJobForTrackingId

Retrieves the ID mapping workflow job associated to the tracking ID.

read
amc_listCollaborationIdMappingJobs

Lists the jobs associated to the given ID mapping table in the collaboration for the requested AMC instance.

read
amc_getCollaborationIdMappingJob

Gets the metadata of the job associated to the ID Mapping Table in the collaboration for the requested AMC instance.

write
amc_refreshCollaborationIdMappingTable

Starts a workflow job to refresh the data in the given ID Mapping Table in the collaboration for the requested AMC instance.

read
amc_listCollaborationIdNamespaces

Lists the advertiser ID namespaces that are not connected to an ID mapping table in the collaboration in the requested AMC instance.

write
amc_createCollaboration

Creates a collaboration in AWS Clean Rooms (ACR).

write
amc_updateCollaborationCustomer

Updates the customer's AWS account ID in the AWS Clean Rooms collaboration associated to the AMC instance.

write
amc_addCollaborationCustomerPartners

Add one or more customer partner members to the AWS Clean Rooms collaboration associated to the AMC instance.

write
amc_updateCollaborationCustomerPartners

Update one or more customer partner members in the AWS Clean Rooms collaboration associated to the AMC instance.

write
amc_deleteCollaborationCustomerPartner

Delete the requested customer partner member in the AWS Clean Rooms collaboration associated to the AMC instance.

write
amc_updateInstanceCustomerAwsAccountMetadata

Updates customer's AWS account metadata in the requested AMC instance.

AMCRuleAudience 6 tools
write
amc_createLookalikeAudience

Creates a lookalike audience execution metadata.

read
amc_getAllQueryBasedAudiencesByInstanceId

Returns list of execution metadata information for a given instanceId.

write
amc_createQueryBasedAudience

Creates a query based audience execution metadata.

write
amc_deleteQueryBasedAudienceByAudienceExecutionId

Deletes an audience for a given instanceId and audienceExecutionId, and any corresponding segments in ADSP or Sponsored Ads Consoles.

read
amc_getQueryBasedAudienceByAudienceExecutionId

Returns execution metadata information for a given instanceId and audienceExecutionId.

write
amc_updateQueryBasedAudienceByAudienceExecutionId

Updates audience configuration for a given audienceExecutionId.

AMCWorkflow 17 tools
read
amc_listDataSources

Returns a list of available data sources.

read
amc_getDataSource

Gets information about the requested data source.

read
amc_listSchedules

Returns a list of schedules.

write
amc_createSchedule

Creates a new schedule.

write
amc_deleteSchedule

Deletes the requested schedule.

read
amc_getSchedule

Gets the requested schedule.

write
amc_updateSchedule

Updates the requested schedule.

read
amc_listWorkflowExecutions

Returns a list of workflow executions.

write
amc_createWorkflowExecution

Creates a new, ad-hoc execution of an existing workflow.

read
amc_getWorkflowExecution

Gets status information about the requested workflow execution.

write
amc_UpdateWorkflowExecution

Updates the requested workflow execution.

read
amc_getWorkflowExecutionDownloadUrls

Generates and returns pre-signed S3 URLs for the result files produced by and metadata used by the provided workflow execution.

read
amc_listWorkflows

Returns a list of workflows.

write
amc_createWorkflow

Creates a new workflow.

write
amc_deleteWorkflow

Deletes the requested workflow.

read
amc_getWorkflow

Gets the requested workflow.

write
amc_updateWorkflow

Updates the requested workflow, using the request body directly as the new workflow definition.

AudiencesDiscovery 4 tools
read
aud_listAudiences

Returns a list of audience segments for an advertiser.

read
aud_fetchTaxonomy

Returns a list of audience categories for a given category path Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Advertising-AccountId Param...

write
aud_DspAudienceDelete

Deletes an existing targeting audience based on audience ID.

write
aud_DspAudienceEdit

Updates an existing targeting audience based on an audience definition and audience ID.

BrandBenchmarks 2 tools
read
br_ListAdvertiserReportMetadata

Gets all of the report metadata the specified advertiser at the specified marketplace.

read
br_GetAdvertiserReport

Gets the download link for an advertiser's metric report in the specified marketplace.

BrandMetrics 2 tools
write
br_generateBrandMetricsReport

Generates the Brand Metrics report in CSV or JSON format.

read
br_getBrandMetricsReport

Fetch the location and status of the report for the brands for which the metrics are available.

BrandStoresManagement 5 tools
read
bsm_ListBrandStoreEdition

Requires one of these permissions: ["amazon_stores_edit","amazon_stores_view"]

read
bsm_QueryBrandStoreEditionPublishVersion

A search read, allowing use of more complex filters.

read
bsm_QueryBrandStorePage

A search read, allowing use of more complex filters.

write
bsm_UpdateBrandStoreEditionPublishVersion

Updates BrandStoreEditionPublishVersions.

write
bsm_UpdateBrandStorePage

Updates BrandStorePages.

CampaignConversionTracking 3 tools
read
campconv_DspGetCampaignConversionTrackingProductsV1

Gets the conversion tracking products for a given campaign.

write
campconv_DspPostProductConversionTrackingV1

Adds products to a campaign to enable product-related conversion metrics.

write
campconv_DspDeleteProductConversionTrackingV1

Removes one or more products from campaign conversion tracking.

CampaignManage 23 tools
write
cm_CreateAdAssociation

Create Ad Association Note: Batch size limits are specific to each ad product.

write
cm_CreateAdExtension

Create ad extensions - API is in open beta Note: Batch size limits are specific to each ad product.

write
cm_CreateAdGroup

Create ad groups Note: Batch size limits are specific to each ad product.

write
cm_CreateAd

Create ads Note: Batch size limits are specific to each ad product.

write
cm_CreateCampaign

Create campaigns Note: Batch size limits are specific to each ad product.

write
cm_CreateTarget

Create target Note: Batch size limits are specific to each ad product.

write
cm_DeleteAdAssociation

Delete Ad Association Note: Batch size limits are specific to each ad product.

write
cm_DeleteAdGroup

Delete ad groups Note: Batch size limits are specific to each ad product.

write
cm_DeleteAd

Delete ads Note: Batch size limits are specific to each ad product.

write
cm_DeleteCampaign

Delete campaigns Note: Batch size limits are specific to each ad product.

write
cm_DeleteTarget

Delete target Note: Batch size limits are specific to each ad product.

read
cm_QueryAdAssociation

Query Ad Association Note: Batch size limits are specific to each ad product.

read
cm_QueryAdExtension

Query ad_extension - API is in open beta Note: Batch size limits are specific to each ad product.

read
cm_QueryAdGroup

List ad groups Note: Batch size limits are specific to each ad product.

read
cm_QueryAd

List ads Note: Batch size limits are specific to each ad product.

read
cm_QueryCampaign

Query campaign Note: Batch size limits are specific to each ad product.

read
cm_QueryTarget

List target Note: Batch size limits are specific to each ad product.

write
cm_UpdateAdAssociation

Update Ad Association Note: Batch size limits are specific to each ad product.

write
cm_UpdateAdExtension

Update ad_extension - API is in open beta Note: Batch size limits are specific to each ad product.

write
cm_UpdateAdGroup

Update ad groups Note: Batch size limits are specific to each ad product.

write
cm_UpdateAd

Update ads Note: Batch size limits are specific to each ad product.

write
cm_UpdateCampaign

Update campaign Note: Batch size limits are specific to each ad product.

write
cm_UpdateTarget

Update target Note: Batch size limits are specific to each ad product.

ChangeHistory 1 tools
read
ac_getHistory

Returns history of changes for provided event sources that match the filters and time ranges specified.

CreativesAssets 6 tools
read
creat_getAsset

Retrieve an asset

write
creat_assetsBatchRegister

This is an asynchronous api that provides clients an identifier for their batch registration request.

read
creat_getAssetsBatchRegister

Retrieves status of the batch asset registration request, uniquely identified by requestId.

write
creat_registerAsset

The API should be called once the asset is uploaded to the location provided by the /asset/upload API endpoint.

read
creat_searchAssets

Search assets

write
creat_getUploadLocation

Creates an ephemeral resource (upload location) to upload Assets to Creative Assets tool.

DataProviderData 5 tools
write
dp_patchV2DpAudience

Associates or disassociates a record with an audience.

write
dp_postV2DpAudiencemetadata

Creates a new data provider audience.

read
dp_getV2DpAudiencemetadataByAudienceId

Gets metadata for an audience specified by identifier.

write
dp_putV2DpAudiencemetadataByAudienceId

Updates metadata of an existing audience specified by identifier.

write
dp_patchV2DpUsers

Deletes user data sourced from data providers.

ExportsSnapshots 5 tools
write
export_AdGroupExport

Creates a file-based export of Ad Groups in the account satisfying the filtering criteria.

write
export_AdExport

Creates a file-based export of Ads in the account satisfying the filtering criteria.

write
export_CampaignExport

Creates a file-based export of Campaigns in the account satisfying the filtering criteria.

read
export_GetExport

This API will return a status of the specified export.

write
export_TargetExport

Creates a file-based export of Targets in the account satisfying the filtering criteria.

Forecasts 1 tools
write
fc_DSPRetrieveCampaignForecast

A retrieve by ID read.

Locations 1 tools
read
loc_listLocations

Note: This endpoint is currently limited to US only.

MediaPlanningReachForecasting 5 tools
write
mp_CreateDeduplicatedReachForecastsV1

Creates a list of De-duplicated Reach Forecasts.

write
mp_GeneratePerformanceForecastsV1

Generates forecast curve for the provided performance metric and targets.

write
mp_CreateReachForecastsV1

Creates a list of new Reach Forecasts in bulk action.

read
mp_ListReachForecastsV1

Gets a list of Reach Forecasts by IDs Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these…

read
mp_ListReachForecastTargetsV1

Gets a list of targets of a Reach Forecast Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these…

ModerationResults 1 tools
write
mod_moderationResults

API to get the moderation results for the ad.

ProductsEligibility 2 tools
read
prod_productEligibility

Gets a list of advertising eligibility objects for a set of products.

write
prod_ProgramEligibility

Checks the advertiser's eligibility to ad programs.

ProductsMetadata 1 tools
write
pm_ProductMetadata

Authorized resource type: DSP Rodeo Entity ID, DSP Advertiser Account ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions: ["advertiser_...

RecommendationsAudienceInsights 1 tools
read
aud_insightsGetAudiencesOverlappingAudiences

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

RecommendationsInsightsPartnerOpportunities 5 tools
read
ri_partnerOpportunitiesListOpportunities

Gets a list of opportunities specific to the partner making the request.

read
ri_partnerOpportunitiesSummarizeOpportunities

Gets aggregated information about all opportunities specific to the partner making the request.

write
ri_partnerOpportunitiesApplicationStatus

Retrieves the current status of applied recommendations.

write
ri_partnerOpportunitiesApply

Applies a given set of recommendations.

read
ri_partnerOpportunitiesGetOpportunityFile

Gets a 307 - TEMPORARY_REDIRECT to an opportunity data file.

RecommendationsInsightsPersonaBuilder 5 tools
write
ri_BandedSize

Get banded size of number of unique customers that are in the input expression.

write
ri_Demographics

Get demographic insights for the input expression.

write
ri_PrimeVideo

Get Prime Video insights for the input expression.

write
ri_TopCategoriesPurchased

Get insights on top retail categories purchased by customers in the input expression.

write
ri_TopOverlappingAudiences

Get top audiences overlapping with the input expression.

RecommendationsInsightsTacticalRecommendations 3 tools
write
ri_ApplyRecommendations

Applies one or more recommendations.

read
ri_ListRecommendations

Retrieves a paginated list of recommendations with optional filtering.

write
ri_UpdateRecommendation

Updates a recommendation.

ReportingMarketingMixModeling 10 tools
write
mmm_createMmmBrandGroupOverrides

Create overrides for brand groups.

write
mmm_deleteMmmBrandGroupOverrides

Delete overrides for brand groups.

read
mmm_listMmmBrandGroupOverrides

List overrides for brand groups.

read
mmm_listMmmBrandGroups

Lists the predefined brand groups for which reports may be requested.

read
mmm_getMmmBrandGroupCampaigns

Returns the list of campaigns associated with the products in a brand group.

read
mmm_getMmmBrandGroupProducts

Returns the list of products in a brand group.

write
mmm_createMmmReport

Creates a report.

read
mmm_listMmmReports

Returns a list of reports and their generation status.

write
mmm_deleteMmmReport

Deletes a report by ID.

read
mmm_getMmmReport

Gets the generation status of a report by ID.

ReportingVersion3 3 tools
write
rp_createAsyncReport

Creates a report request.

write
rp_deleteAsyncReport

Deletes a report by id.

read
rp_getAsyncReport

Gets a generation status of a report by id.

SponsoredBrandsV3 38 tools
read
sb_getBrands

Gets an array of Brand data objects for the Brand associated with the profile ID passed in the header.

read
sb_describeMedia

API to poll for media status.

read
sb_listAsins

Note that for sellers, the addresss must be a Store page.

write
sb_SBGetBudgetRulesRecommendation

A rule enables an automatic budget increase for a specified date range or for a special event.

read
sb_listKeywords

Note: Keywords associated with BrandVideo ad groups are only available in v3.2 version.

write
sb_createKeywords

Note that state can't be set at keyword creation.

write
sb_updateKeywords

Updates one or more targeting clauses.

write
sb_archiveKeyword

This operation is equivalent to an update operation that sets the status field to 'archived'.

read
sb_getKeyword

Gets a keyword specified by identifier.

read
sb_getSbModerationCampaignsByCampaignId

Deprecated: do not use.

read
sb_listNegativeKeywords

Note: Negative keywords associated with BrandVideo ad groups are only available in v3.2 version.

write
sb_createNegativeKeywords

Creates one or more negative targeting clauses.

write
sb_updateNegativeKeywords

Updates one or more targeting clauses.

write
sb_archiveNegativeKeyword

This operation is equivalent to an update operation that sets the status field to 'archived'.

read
sb_getNegativeKeyword

Gets a negative keyword specified by identifier.

write
sb_createNegativeTargets

Create one or more negative targets.

write
sb_updateNegativeTargets

Updates one or more negative targets.

read
sb_listNegativeTargets

Note: Negative targets associated with BrandVideo ad groups are only available in v3.2 version.

write
sb_archiveNegativeTarget

Archives a negative target specified by identifier.

read
sb_getNegativeTarget

Gets a negative target specified by identifier.

read
sb_getBidsRecommendations

Get a list of bid recommendation objects for a specified list of keywords or products.

read
sb_getKeywordRecommendations

Gets an array of keyword recommendation objects for a set of ASINs included either on a landing page or a Stores page.

read
sb_getBrandRecommendations

The Brand suggestions are based on a list of either category identifiers or keywords passed in the request.

read
sb_getTargetingCategories

Recommendations are based on the ASINs that are passed in the request.

read
sb_getProductRecommendations

Recommendations are based on the ASINs that are passed in the request.

write
sb_createTargets

Create one or more targets.

write
sb_updateTargets

Updates one or more targets.

read
sb_listTargets

Gets a list of product targets associated with the client identifier passed in the authorization header, filtered by specified criteria.

write
sb_archiveTarget

The identifier of an existing target.

read
sb_getTarget

Gets a target specified by identifier.

write
sb_sbCreateThemes

Note that this endpoint does not support for Author profiles.

write
sb_sbUpdateThemes

Note that this endpoint does not support for Author profiles.

read
sb_sbListThemes

Note that this endpoint does not support for Author profiles.

read
sb_listAssets

For sellers or vendors, gets an array of assets associated with the specified brand entity identifier.

write
sb_createAsset

Image assets are stored in the Store Assets Library.

write
sb_postV2HsaByRecordTypeReport

Use this interface to request and retrieve performance reports.

read
sb_getV2ReportsByReportId

To understand the call flow for asynchronous reports, see Getting started with sponsored ads reports.

read
sb_downloadReport

Gets a 307 Temporary Redirect response that includes a location header with the value set to an AWS S3 path where the report is located.

SponsoredBrandsV4 54 tools
write
sb_UpdateSponsoredBrandsAutoCollectionAds

Updates the ad settings for an automatic collection by creating a new version Requires one of these permissions: ["advertiser_campaign_edit"]

write
sb_CreateBrandVideoCreative

This API creates a new version of an existing creative for given Sponsored Brands Ad by supplying brand video creative content Requires one of these permissions: ["advertiser_campaign_edit"]

read
sb_ListCreatives

This API gets an array of all Sponsored Brands creatives that qualify the given resource identifiers and filters Requires one of these permissions:…

write
sb_UpdateSponsoredBrandsManualCollectionAds

Updates the ad settings for a manual collection by creating a new version Requires one of these permissions: ["advertiser_campaign_edit"]

write
sb_CreateProductCollectionCreative

Deprecated: do not use.

write
sb_CreateExtendedProductCollectionCreative

Deprecated: do not use.

write
sb_CreateStoreSpotlightCreative

This API creates a new version of creative for given Sponsored Brands ad by supplying store spotlight creative content Requires one of these permissions: ["advertiser_campaign_edit"]

write
sb_CreateVideoCreative

This API creates a new version of an existing creative for given Sponsored Brands ad by supplying video creative content Requires one of these permissions: ["advertiser_campaign_edit"]

read
sb_GetSBBudgetRulesForAdvertiser

Get budget rules

write
sb_CreateBudgetRulesForSBCampaigns

Requires one of these permissions: ["advertiser_campaign_edit"]

write
sb_UpdateBudgetRulesForSBCampaigns

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sb_GetBudgetRuleByRuleIdForSBCampaigns

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sb_GetCampaignsAssociatedWithSBBudgetRule

Get campaigns associated with budget rule

write
sb_sbCampaignsBudgetUsage

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sb_GetBudgetRecommendations

Provides daily budget recommendations for a list of requested Sponsored Brands campaigns, with context on estimated historical missed opportunities.

write
sb_SBInsightsCampaignInsights

Creates campaign level insights.

read
sb_ListAssociatedBudgetRulesForSBCampaigns

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sb_CreateAssociatedBudgetRulesForSBCampaigns

A maximum of 250 rules can be associated to a campaign.

write
sb_DisassociateAssociatedBudgetRuleForSBCampaigns

Requires one of these permissions: ["advertiser_campaign_edit"]

write
sb_SBCampaignPerformanceForecasts

Returns forecasts for a list of new campaigns specified in SB forecast request.

read
sb_SBTargetingGetNegativeBrands

Returns brands recommended for negative targeting.

read
sb_getHeadlineRecommendations

API to receive creative headline suggestions.

write
sb_SBOptimizationRecommendation

Returns recommended bid value for optimization rule enable campaigns.

write
sb_CreateSponsoredBrandsOptimizationRules

Currently available in beta.

write
sb_UpdateSponsoredBrandsOptimizationRules

Currently available in beta.

write
sb_AssociateSponsoredBrandsOptimizationRules

Currently available in beta.

write
sb_DisassociateSponsoredBrandsOptimizationRules

Currently available in beta.

read
sb_ListSponsoredBrandsOptimizationRules

Currently available in beta.

read
sb_SBTargetingGetTargetableCategories

Returns all targetable categories by default in a list.

read
sb_SBTargetingGetRefinementsForCategory

Returns refinements according to category input.

read
sb_SBTargetingGetTargetableASINCounts

Get number of targetable asins based on refinements provided by the user.

write
sb_CreateSponsoredBrandsAdGroups

Creates Sponsored Brands ad groups.

write
sb_UpdateSponsoredBrandsAdGroups

Updates Sponsored Brands ad groups.

write
sb_DeleteSponsoredBrandsAdGroups

Deletes Sponsored Brands ad groups.

read
sb_ListSponsoredBrandsAdGroups

Lists Sponsored Brands ad groups.

write
sb_UpdateSponsoredBrandsAds

Updates Sponsored Brands ads.

write
sb_CreateSponsoredBrandsAutoCollectionAds

Creates Sponsored Brands automatic collection ads.

write
sb_CreateSponsoredBrandsBrandVideoAds

Creates Sponsored Brands brand video ads.

write
sb_DeleteSponsoredBrandsAds

Deletes Sponsored Brands ads.

read
sb_ListSponsoredBrandsAds

Lists Sponsored Brands ads.

write
sb_CreateSponsoredBrandsManualCollectionAds

Creates Sponsored Brands manual collection ads.

write
sb_CreateSponsoredBrandsProductCollectionAds

Deprecated: do not use.

write
sb_CreateSponsoredBrandsExtendedProductCollectionAds

Deprecated: do not use.

write
sb_CreateSponsoredBrandStoreSpotlightAds

Creates Sponsored Brands store spotlight ads.

write
sb_CreateSponsoredBrandsVideoAds

Creates Sponsored Brands video ads.

write
sb_CreateSponsoredBrandsCampaigns

Creates Sponsored Brands campaigns.

write
sb_UpdateSponsoredBrandsCampaigns

Updates Sponsored Brands campaigns.

write
sb_DeleteSponsoredBrandsCampaigns

Deletes Sponsored Brands campaigns.

read
sb_ListSponsoredBrandsCampaigns

Lists Sponsored Brands campaigns.

write
sb_StartMigrationJob

Creates Migration Job for V3 campaigns.

write
sb_MigrationJobResults

List Migration Results of all Campaign.

write
sb_MigrationJobStatus

List Migration Job Status.

write
sb_MigrationResults

Lists all Campaign Migration results for an advertiser

read
sb_ListMigrations

Lists eligible Product Collection ads with recommended SB Collection replacement options.

SponsoredDisplay 76 tools
read
sd_listAdGroups

Gets an array of AdGroup objects for a requested set of Sponsored Display ad groups.

write
sd_createAdGroups

Creates one or more ad groups.

write
sd_updateAdGroups

Updates on or more ad groups.

read
sd_listAdGroupsEx

Gets an array of AdGroupResponseEx objects for a set of requested ad groups.

read
sd_getAdGroupResponseEx

Gets extended information for a requested ad group.

write
sd_archiveAdGroup

This operation is equivalent to an update operation that sets the status field to 'archived'.

read
sd_getAdGroup

Returns an AdGroup object for a requested campaign.

read
sd_getSdAdGroupsByAdGroupIdOptimizationRules

Gets an OptimizationRule object for a requested Sponsored Display optimization rule.

write
sd_associateOptimizationRulesWithAdGroup

When an optimization rule is associated to an ad group, manual bids for individual targets will be overridden.

write
sd_disassociateOptimizationRulesFromAdGroup

Only one optimization rule can be disassociated per adGroup.

write
sd_deleteBrandSafetyDenyList

Archives all of the domains in the Brand Safety Deny List.

read
sd_listDomains

Gets an array of websites/apps that are on the advertiser's Brand Safety Deny List.

write
sd_createBrandSafetyDenyListDomains

Creates one or more domains to add to a Brand Safety Deny List.

read
sd_listRequestStatus

List status of all Brand Safety List requests.

read
sd_getRequestResults

When a user adds domains to their Brand Safety Deny List, the request is processed asynchronously, and a requestId is provided to the user.

read
sd_getRequestStatus

When a user modifies their Brand Safety Deny List, the request is processed asynchronously, and a requestId is provided to the user.

read
sd_GetSDBudgetRulesForAdvertiser

Get all budget rules created by an advertiser

write
sd_CreateBudgetRulesForSDCampaigns

Creates one or more budget rules.

write
sd_UpdateBudgetRulesForSDCampaigns

Update one or more budget rules.

read
sd_GetBudgetRuleByRuleIdForSDCampaigns

Gets a budget rule specified by identifier.

read
sd_GetCampaignsAssociatedWithSDBudgetRule

Gets all the campaigns associated with a budget rule

read
sd_listCampaigns

Gets an array of Campaign objects for a requested set of Sponsored Display campaigns.

write
sd_createCampaigns

Creates one or more campaigns.

write
sd_updateCampaigns

Updates one or more campaigns.

write
sd_sdCampaignsBudgetUsage

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sd_getSDBudgetRecommendations

Given a list of campaigns as input, this API provides the following metrics: 1.

read
sd_listCampaignsEx

Gets an array of CampaignResponseEx objects for a set of requested campaigns.

read
sd_getCampaignResponseEx

Returns a CampaignResponseEx object for a requested campaign.

write
sd_archiveCampaign

This operation is equivalent to an update operation that sets the status field to 'archived'.

read
sd_getCampaign

Returns a Campaign object for a requested campaign.

read
sd_ListAssociatedBudgetRulesForSDCampaigns

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sd_CreateAssociatedBudgetRulesForSDCampaigns

A maximum of 250 rules can be associated to a campaign.

write
sd_DisassociateAssociatedBudgetRuleForSDCampaigns

Disassociates a budget rule specified by identifier from a campaign specified by identifier.

read
sd_listCreatives

Gets a list of creatives

write
sd_createCreatives

A POST request of one or more creatives.

write
sd_updateCreatives

Updates one or more creatives.

read
sd_postCreativePreview

Gets creative preview HTML.

write
sd_createSDForecast

Returns forecasts for a given ad group specified in SD forecast request.

read
sd_listLocations

Gets a list of Sponsored Display Location objects.

write
sd_createLocations

This resource is not available when productAds have ASIN or SKU fields and only available for advertisers that do not sell products on Amazon.

write
sd_archiveLocations

This is a bulk operation that accepts up to a limit of 1000 Location Expression Ids at a time.

read
sd_listCreativeModerations

Gets a list of creative moderations

read
sd_listNegativeTargetingClauses

Gets a list of negative targeting clauses objects for a requested set of Sponsored Display negative targets.

write
sd_createNegativeTargetingClauses

Successfully created negative targeting clauses associated with an ad group are assigned a unique target identifier.

write
sd_updateNegativeTargetingClauses

Updates one or more negative targeting clauses.

read
sd_listNegativeTargetingClausesEx

Gets an array of NegativeTargetingClauseEx objects for a set of requested negative targets.

read
sd_getNegativeTargetsEx

Gets a negative targeting clause with extended fields.

write
sd_archiveNegativeTargetingClause

Equivalent to using the updateNegativeTargetingClauses operation to set the state property of a targeting clause to archived.

read
sd_getNegativeTargets

This call returns the minimal set of negative targeting clause fields, but is more efficient than getNegativeTargetsEx.

read
sd_listOptimizationRules

Gets an array of OptimizationRule objects for a requested set of Sponsored Display optimization rules.

write
sd_createOptimizationRules

When an optimization rule is associated to an ad group, manual bids for individual targets will be overridden.

write
sd_updateOptimizationRules

Updates one or more optimization rules.

read
sd_getSdOptimizationRulesByOptimizationRuleId

Gets an OptimizationRule object for a requested Sponsored Display optimization rule.

read
sd_listProductAds

Gets an array of ProductAd objects for a requested set of Sponsored Display product ads.

write
sd_createProductAds

Creates one or more product ads.

write
sd_updateProductAds

Updates one or more product ads.

read
sd_listProductAdsEx

Gets an array of ProductAdResponseEx objects for a set of requested ad groups.

read
sd_getProductAdResponseEx

Gets extended information for a product ad.

write
sd_archiveProductAd

This operation is equivalent to an update operation that sets the status field to 'archived'.

read
sd_getProductAd

Note that the ProductAd object is designed for performance, and includes a small set of commonly used fields to reduce size.

read
sd_getHeadlineRecommendationsForSD

You can use this Sponsored Display API to retrieve creative headline recommendations from an array of ASINs.

read
sd_getSnapshot

Note: Snapshots APIs are deprecated and will be shut off on October 15, 2024.

read
sd_downloadSnapshot

Note: Snapshots APIs are deprecated and will be shut off on October 15, 2024.

read
sd_listTargetingClauses

Gets a list of targeting clauses objects for a requested set of Sponsored Display targets.

write
sd_createTargetingClauses

Successfully created targeting clauses are assigned a unique targetId value.

write
sd_updateTargetingClauses

Updates one or more targeting clauses.

read
sd_getTargetBidRecommendations

Provides a list of bid recommendations based on the list of input advertised ASINs and targeting clauses in the same format as the targeting API.

read
sd_listTargetingClausesEx

Gets an array of TargetingClauseEx objects for a set of requested targets.

read
sd_getTargetsEx

Gets a targeting clause object with extended fields.

read
sd_getTargetRecommendations

This API provides product, category and standard audience recommendations to target based on the list of input ASINs.

write
sd_archiveTargetingClause

Equivalent to using the updateTargetingClauses operation to set the state property of a targeting clause to archived.

read
sd_getTargets

This call returns the minimal set of targeting clause fields.

write
sd_requestReport

To understand the call flow for asynchronous reports, see Getting started with sponsored ads reports.

write
sd_createSnapshot

Note: Snapshots APIs are deprecated and will be shut off on October 15, 2024.

read
sd_getReportStatus

Uses the reportId value from the response of a report previously requested via POST method of the /sd/{recordType}/report operation.

read
sd_downloadReport

Gets a 307 Temporary Redirect response that includes a location header with the value set to an AWS S3 path where the report is located.

SponsoredProducts 80 tools
write
sp_CreateSponsoredProductsAdGroups

Create ad groups Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsAdGroups

Update ad groups Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_DeleteSponsoredProductsAdGroups

Delete ad groups Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsAdGroups

List ad groups Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sp_GetSPBudgetRulesForAdvertiser

Get all budget rules created by an advertiser

write
sp_CreateBudgetRulesForSPCampaigns

Requires one of these permissions: ["advertiser_campaign_edit"]

write
sp_UpdateBudgetRulesForSPCampaigns

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sp_GetBudgetRuleByRuleIdForSPCampaigns

Authorized resource type: Global Ad Account ID, Profile ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions:…

read
sp_GetCampaignsAssociatedWithSPBudgetRule

Gets all the campaigns associated with a budget rule

write
sp_BulkBudgetRulesAssociationForSP

A maximum of 250 rules can be associated to a campaign.

write
sp_BulkBudgetRulesDisAssociationForSP

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sp_getCampaignRecommendations

Gets the top consolidated recommendations across bid, budget, targeting for SP campaigns given an advertiser profile id.

read
sp_fetchCampaignRecommendations

Gets the top consolidated recommendations across bid, budget, targeting for SP campaigns given an advertiser profile id.

write
sp_CreateSponsoredProductsCampaignNegativeKeywords

Create campaign negative keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsCampaignNegativeKeywords

Update campaign negative keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_DeleteSponsoredProductsCampaignNegativeKeywords

Delete campaign negative keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsCampaignNegativeKeywords

List campaign negative keywords Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateSponsoredProductsCampaignNegativeTargetingClauses

Create campaign negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsCampaignNegativeTargetingClauses

Update campaign negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_DeleteSponsoredProductsCampaignNegativeTargetingClauses

Delete campaign negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsCampaignNegativeTargetingClauses

List campaign negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateSponsoredProductsCampaigns

Create campaigns Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsCampaigns

Update campaigns Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_spCampaignsBudgetUsage

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sp_getBudgetRecommendations

Given a list of campaigns as input, this API provides the following metrics - 1.

write
sp_SPGetBudgetRulesRecommendation

A rule enables an automatic budget increase for a specified date range or for a special event.

write
sp_DeleteSponsoredProductsCampaigns

Delete campaigns Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_getBudgetRecommendation

Creates daily budget recommendation along with benchmark metrics when creating a new campaign.

read
sp_ListSponsoredProductsCampaigns

List campaigns Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sp_ListAssociatedBudgetRulesForSPCampaigns

Authorized resource type: Global Ad Account ID, Profile ID Parameter name: Amazon-Ads-AccountId Parameter in: header Requires one of these permissions:…

write
sp_CreateAssociatedBudgetRulesForSPCampaigns

A maximum of 250 rules can be associated to a campaign.

write
sp_DisassociateAssociatedBudgetRuleForSPCampaigns

Requires one of these permissions: ["advertiser_campaign_edit"]

write
sp_AssociateOptimizationRulesToCampaign

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sp_GetMultiCountryThemeBasedBidRecommendationForAdGroup_v1

The POST /sp/targets/bid/recommendations endpoint returns recommended bids for each target given either A) new ad group (a list of ad ASINs) or B) existing ad group (a campaign ID and ad grou...

read
sp_getGlobalRankedKeywordRecommendation

The POST /sp/global/targets/keywords/recommendations/list endpoint returns recommended keyword targets for a list of countries given either A) a list of ad ASINs per target country or B) a gl...

write
sp_CreateSponsoredProductsKeywords

Create keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsKeywords

Update keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_DeleteSponsoredProductsKeywords

Delete keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsKeywords

List keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_CreateSponsoredProductsNegativeKeywords

Create negative keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsNegativeKeywords

Update negative keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_DeleteSponsoredProductsNegativeKeywords

Delete negative keywords Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsNegativeKeywords

List negative keywords Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateSponsoredProductsNegativeTargetingClauses

Create negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsNegativeTargetingClauses

Update negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_getNegativeBrands

Returns brands recommended for negative targeting.

read
sp_searchBrands

Returns up to 100 brands related to keyword input for negative targeting.

write
sp_DeleteSponsoredProductsNegativeTargetingClauses

Delete negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsNegativeTargetingClauses

List negative targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateSponsoredProductsProductAds

Create product ads Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsProductAds

Update product ads Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_DeleteSponsoredProductsProductAds

Delete product ads Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_ListSponsoredProductsProductAds

List product ads Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateOptimizationRule

Requires one of these permissions: ["advertiser_campaign_edit"]

write
sp_UpdateOptimizationRule

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sp_GetOptimizationRuleEligibility

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sp_GetRuleNotification

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_DeleteCampaignOptimizationRule

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sp_GetCampaignOptimizationRule

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateOptimizationRules

Requires one of these permissions: ["advertiser_campaign_edit"]

write
sp_UpdateOptimizationRules

Requires one of these permissions: ["advertiser_campaign_edit"]

read
sp_SearchOptimizationRules

Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

write
sp_CreateTargetPromotionGroups

Creates a target promotion group, by grouping the auto-targeting adGroupId and manual-targeting adGroups, divided by keyword targeting adGroups, and product targeting adGroups.

read
sp_ListTargetPromotionGroups

Returns the target promotion groups for an advertiser and / or adGroupId, and / or target promotion group id.

read
sp_GetTargetPromotionGroupsRecommendations

Retrieves keyword and product targets of an auto-targeting campaign as recommendations for promoting to a manual-targeting campaign.

write
sp_CreateTargetPromotionGroupTargets

Creates keyword and/or product targets in the manual adGroup that are part of the target promotion group Requires one of these permissions: ["advertiser_campaign_edit","advertiser_campaign_view"]

read
sp_ListTargetPromotionGroupTargets

Returns the targets created through target promotion groups for an advertiser and / or given target promotion group.

read
sp_getKeywordGroupRecommendations

This API (currently beta) recommends Keyword Group targets for a given list of Ad ASINs.

write
sp_CreateSponsoredProductsTargetingClauses

Create targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

write
sp_UpdateSponsoredProductsTargetingClauses

Update targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_GetThemeBasedBidRecommendationForAdGroup_v1

The POST /sp/targets/bid/recommendations endpoint returns recommended bids for each target given either A) new ad group (a list of ad ASINs) or B) existing ad group (a campaign ID and ad grou...

read
sp_getTargetableCategories

Returns all targetable categories.

read
sp_getCategoryRecommendationsForASINs

Returns a list of category recommendations for the input list of ASINs.

read
sp_getRefinementsForCategory

Returns refinements according to category input.

write
sp_DeleteSponsoredProductsTargetingClauses

Delete targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_getRankedKeywordRecommendation

The POST /sp/targets/keywords/recommendations endpoint returns recommended keyword targets given either A) a list of ad ASINs or B) a campaign ID and ad group ID.

read
sp_ListSponsoredProductsTargetingClauses

List targeting clauses Requires one of these permissions: ["advertiser_campaign_edit","campaign_proposed"]

read
sp_getTargetableASINCounts

Get number of targetable asins based on refinements provided by the user.

read
sp_getProductRecommendations

Given an advertised ASIN as input, this API returns suggested ASINs to target in a product targeting campaign.

write
sp_SPGetAllRuleEvents

A rule enables an automatic budget increase for a specified date range or for a special event.

SPSnapshotsSuggestedKeywords 11 tools
read
sp_getAdGroupBidRecommendations

Deprecation notice: This endpoint will be deprecated on March 27, 2024.

read
sp_getAdGroupSuggestedKeywords

DEPRECATED - Gets suggested keywords for the specified ad group.

read
sp_getAdGroupSuggestedKeywordsEx

DEPRECATED - Gets suggested keywords with extended data for the specified ad group.

write
sp_bulkGetAsinSuggestedKeywords

Suggested keywords are returned in an array ordered by descending effectiveness.

read
sp_getAsinSuggestedKeywords

Suggested keywords are returned in an array ordered by descending effectiveness.

write
sp_createKeywordBidRecommendations

Deprecation notice: This endpoint will be deprecated on March 27, 2024.

read
sp_getKeywordBidRecommendations

Deprecation notice: This endpoint will be deprecated on March 27, 2024.

read
sp_getSnapshotStatus

Note: Snapshots APIs are deprecated and will be shut off on October 15, 2024.

read
sp_downloadSnapshot

Note: Snapshots APIs are deprecated and will be shut off on October 15, 2024.

read
sp_getBidRecommendations

DEPRECATED - Gets a list of bid recommendations for keyword, product, or auto targeting expressions.

write
sp_requestSnapshot

Note: Snapshots APIs are deprecated and will be shut off on October 15, 2024.

StoresAnalytics 2 tools
read
st_getAsinEngagementForStore

Store asin metrics provides information about your store asin performance, including rendered impressions, viewed impressions, clicks and sales.

read
st_getInsightsForStoreAPI

Stores insights provides information about your store's performance, including traffic and sales.

TestAccount 2 tools
read
test_GetAccountInformation

API to get Account information.

write
test_createAccount

Submit a account creation request.

UnifiedPreModerationResults 1 tools
write
mod_preModeration

This API will be accepting different components of the ad/page and will be automatically validating the components and send back the policy violations if any.