Amazon Ads API MCP

{"components":{"schemas":{"AccountInfo":{"properties":{"id":{"description":"Identifier for sellers and vendors. Note that this value is not unique and may be the same across marketplace.","readOnly":true,"type":"string"},"marketplaceStringId":{"description":"The identifier of the marketplace to which the account is associated.","readOnly":true,"type":"string"},"name":{"description":"Account name.","readOnly":true,"type":"string"},"subType":{"description":"The account subtype.","enum":["KDP_AUTHOR","AMAZON_ATTRIBUTION"],"readOnly":true,"type":"string"},"type":{"$ref":"#/components/schemas/AccountType"},"validPaymentMethod":{"description":"Only present for Vendors, this returns whether the Advertiser has set up a valid payment method or not.","readOnly":true,"type":"boolean"}}},"AccountType":{"description":"The `seller` and `vendor` account types are associated with Sponsored Ads APIs. The `agency` account type is associated with DSP and Data Provider APIs.","enum":["vendor","seller","agency"],"readOnly":true,"type":"string"},"Profile":{"properties":{"accountInfo":{"$ref":"#/components/schemas/AccountInfo"},"countryCode":{"$ref":"#/components/schemas/countryCode"},"currencyCode":{"description":"The currency used for all monetary values for entities under this profile.\n|Region|`countryCode`|Country Name|`currencyCode`|\n|-----|------|------|------|\n|NA|BR|Brazil|BRL|\n|NA|CA|Canada|CAD|\n|NA|MX|Mexico|MXN|\n|NA|US|United States|USD|\n|EU|AE|United Arab Emirates|AED|\n|EU|BE|Belgium|EUR|\n|EU|DE|Germany|EUR|\n|EU|EG|Egypt|EGP|\n|EU|ES|Spain|EUR|\n|EU|FR|France|EUR|\n|EU|IE|Ireland|EUR|\n|EU|IN|India|INR|\n|EU|IT|Italy|EUR|\n|EU|NL|The Netherlands|EUR|\n|EU|PL|Poland|PLN|\n|EU|SA|Saudi Arabia|SAR|\n|EU|SE|Sweden|SEK|\n|EU|TR|Turkey|TRY|\n|EU|UK|United Kingdom|GBP|\n|EU|ZA| South Africa | ZAR|\n|FE|AU|Australia|AUD|\n|FE|JP|Japan|JPY|\n|FE|SG|Singapore|SGD|","enum":["BRL","CAD","MXN","USD","AED","EUR","EGP","INR","PLN","SAR","SEK","TRY","GBP","AUD","JPY","SGD","ZAR"],"readOnly":true,"type":"string"},"dailyBudget":{"description":"Note that this field applies to Sponsored Product campaigns for seller type accounts only. Not supported for vendor type accounts.","readOnly":false,"type":"number"},"profileId":{"format":"int64","type":"integer"},"timezone":{"description":"The time zone used for all date-based campaign management and reporting.\n|Region|`countryCode`|Country Name|`timezone`|\n|------|-----|-----|------|\n|NA|BR|Brazil|America/Sao_Paulo|\n|NA|CA|Canada|America/Los_Angeles|\n|NA|MX|Mexico|America/Los_Angeles|\n|NA|US|United States|America/Los_Angeles|\n|EU|AE|United Arab Emirates|Asia/Dubai|\n|EU|BE|Belgium|Europe/Brussels|\n|EU|DE|Germany|Europe/Paris|\n|EU|EG|Egypt|Africa/Cairo|\n|EU|ES|Spain|Europe/Paris|\n|EU|FR|France|Europe/Paris|\n|EU|IE|Ireland|Europe/Dublin|\n|EU|IN|India|Asia/Kolkata|\n|EU|IT|Italy|Europe/Paris|\n|EU|NL|The Netherlands|Europe/Amsterdam|\n|EU|PL|Poland|Europe/Warsaw|\n|EU|SA|Saudi Arabia|Asia/Riyadh|\n|EU|SE|Sweden|Europe/Stockholm|\n|EU|TR|Turkey|Europe/Istanbul|\n|EU|UK|United Kingdom|Europe/London|\n|EU|ZA| South Africa | Africa/Johannesburg |\n|FE|AU|Australia|Australia/Sydney|\n|FE|JP|Japan|Asia/Tokyo|\n|FE|SG|Singapore|Asia/Singapore|","enum":["Africa/Cairo","America/Sao_Paulo","America/Los_Angeles","Asia/Dubai","Asia/Kolkata","Asia/Riyadh","Asia/Singapore","Asia/Tokyo","Australia/Sydney","Europe/Amsterdam","Europe/Dublin","Europe/Istanbul","Europe/London","Europe/Paris","Europe/Stockholm","Europe/Warsaw","Europe/Brussels","Africa/Johannesburg"],"readOnly":true,"type":"string"}}},"ProfileResponse":{"properties":{"code":{"type":"string"},"details":{"type":"string"},"profileId":{"format":"int64","type":"integer"}}},"countryCode":{"description":"The countryCode for a given country\n|Region|`countryCode`|Country Name|\n|------|-----|-------|\n|NA|BR|Brazil|\n|NA|CA|Canada|\n|NA|MX|Mexico|\n|NA|US|United States|\n|EU|AE|United Arab Emirates|\n|EU|BE|Belgium| \n|EU|DE|Germany|\n|EU|EG|Egypt|\n|EU|ES|Spain|\n|EU|FR|France|\n|EU|IE|Ireland|\n|EU|IN|India|\n|EU|IT|Italy|\n|EU|NL|The Netherlands|\n|EU|PL|Poland|\n|EU|SA|Saudi Arabia| \n|EU|SE|Sweden| \n|EU|TR|Turkey|\n|EU|UK|United Kingdom|\n|EU|ZA| South Africa |\n|FE|AU|Australia| \n|FE|JP|Japan|\n|FE|SG|Singapore|","enum":["BR","CA","MX","US","AE","BE","DE","EG","ES","FR","IE","IN","IT","NL","PL","SA","SE","TR","UK","AU","JP","SG","ZA"],"readOnly":true,"type":"string"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"},"oauth2AuthorizationCode":{"description":"Login with Amazon. For more information see [Login with Amazon authorization code grant](https://developer.amazon.com/docs/login-with-amazon/authorization-code-grant.html).","flows":{"authorizationCode":{"authorizationUrl":"https://www.amazon.com/ap/oa","scopes":{"cpc_advertising:campaign_management":"Modify your advertising campaigns and access performance data"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"contact":{"name":"Amazon Ads API Support","url":"https://amzn-clicks.atlassian.net/servicedesk/customer/portals"},"description":"Profiles represent an advertiser and their account's marketplace, and are used in all subsequent API calls via a management scope, `Amazon-Advertising-API-Scope`. Reports and all entity management operations are associated with a single profile. Advertisers cannot have more than one profile for each marketplace.\n\nAdvertisers who operate in more than one marketplace (for example, Amazon.com, Amazon.co.uk, Amazon.co.jp) will have only one profile associated with each marketplace. [**See this link**](https://advertising.amazon.com/API/docs/en-us/info/api-overview#api-endpoints) for a list of marketplaces associated with each endpoint.\n\nTo retrieve your profile IDs, call the listProfiles operation, and include a valid authorization access token in the header. Use a `profileId` from the returned list as the value for the management scope (`Amazon-Advertising-API-Scope`) in the headers for subsequent API calls.","license":{"name":"Amazon Ads API License Agreement","url":"https://advertising.amazon.com/API/docs/license-agreement"},"title":"Amazon Ads API - Profiles","version":"3.0"},"openapi":"3.0.3","paths":{"/v2/profiles":{"get":{"description":"Note that this operation does not return a response unless the current account has created at least one campaign using the advertising console.","operationId":"listProfiles","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"Filters response to include profiles that have permissions for the specified Advertising API program only. Setting `apiProgram=billing` filters the response to include only profiles to which the user and application associated with the access token have permission to view or edit billing information.","in":"query","name":"apiProgram","schema":{"default":"campaign","enum":["billing","campaign","paymentMethod","store","report","account","posts"],"type":"string"}},{"description":"Filters response to include profiles that have specified permissions for the specified Advertising API program only. Currently, the only supported access level is `view` and `edit`. Setting `accessLevel=view` filters the response to include only profiles to which the user and application associated with the access token have view permission to the provided api program.","in":"query","name":"accessLevel","schema":{"default":"view","enum":["edit","view"],"type":"string"}},{"description":"Filters response to include profiles that are of the specified types in the comma-delimited list. Default is all types. Note that this filter performs an inclusive AND operation on the types.","in":"query","name":"profileTypeFilter","schema":{"enum":["seller","vendor","agency"],"type":"string"}},{"description":"Filter response to include profiles that have valid payment methods. Default is to include all profiles. Setting this filter to `true` returns only profiles with either no `validPaymentMethod` field, or the `validPaymentMethod` field set to `true`. Setting this to `false` returns profiles with the `validPaymentMethod` field set to `false` only.","in":"query","name":"validPaymentMethodFilter","schema":{"enum":["true","false"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Profile"},"maxItems":5000,"type":"array"}}},"description":"Success."}},"summary":"Gets a list of profiles.","tags":["Profiles"]},"put":{"description":"Note that this operation is only used for Sellers using Sponsored Products. This operation is not enabled for vendor type accounts.","operationId":"updateProfiles","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Profile"},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProfileResponse"},"type":"array"}}},"description":"success"}},"summary":"Update the daily budget for one or more profiles.","tags":["Profiles"]}},"/v2/profiles/{profileId}":{"get":{"description":"This operation does not return a response unless the current account has created at least one campaign using the advertising console.","operationId":"getProfileById","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"in":"path","name":"profileId","required":true,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}},"description":"Success."}},"summary":"Gets a profile specified by identifier.","tags":["Profiles"]}}},"security":[{"oauth2AuthorizationCode":["cpc_advertising:campaign_management"]},{"bearerAuth":[]}],"servers":[{"url":"https://advertising-api.amazon.com"},{"url":"https://advertising-api-eu.amazon.com"},{"url":"https://advertising-api-fe.amazon.com"}],"tags":[{"name":"Profiles"}]}