Amazon Ads API MCP

{"components":{"schemas":{"DspAdvertiserV1":{"description":"The DSP Advertiser object","properties":{"advertiserId":{"description":"The advertiser identifier.","type":"string"},"country":{"$ref":"#/components/schemas/DspCountryV1"},"currency":{"$ref":"#/components/schemas/DspSupportedCurrencyV1"},"name":{"description":"The advertiser name.","type":"string"},"timezone":{"$ref":"#/components/schemas/DspTimezoneV1"},"url":{"description":"The URL of the advertiser’s website.","type":"string"}},"type":"object"},"DspAdvertisersV1":{"description":"List of advertisers along with total number of advertisers which satisfy the filtering criteria.","properties":{"response":{"description":"List of advertisers with complete information.","items":{"$ref":"#/components/schemas/DspAdvertiserV1","properties":{}},"type":"array"},"totalResults":{"description":"Total number of advertisers which satisfy the filtering criteria. This number is given to support pagination and tell the client if there are more advertisers to be fetched.","format":"int32","type":"integer"}},"type":"object"},"DspCountryV1":{"description":"The country code.","enum":["US","CA","MX","JP","AU","IN","UK","GB","DE","FR","IT","ES","AT","AE","SA","BR","NL","SE","SG","TR"],"type":"string"},"DspErrorV1":{"description":"Error response object.","properties":{"errors":{"description":"List of errors. Useful in case of validation errors","items":{"$ref":"#/components/schemas/DspSubErrorV1","properties":{}},"type":"array"},"message":{"description":"A human-readable description of the response.","type":"string"},"requestId":{"description":"A value will be used to identify your request uniquely.","type":"string"}},"required":["message"],"type":"object"},"DspSubErrorV1":{"description":"Error Object","properties":{"errorType":{"description":"Enumerated error type.","type":"string"},"field":{"description":"Request body field which is cause of the error.","type":"string"},"message":{"description":"Detailed error description","type":"string"}},"required":["errorType","message"],"type":"object"},"DspSupportedCurrencyV1":{"description":"The supported currencies.","enum":["USD","CAD","JPY","GBP","EUR","INR","MXN","AED","SAR","BRL","AUD","SEK","SGD","TRY"],"type":"string"},"DspTimezoneV1":{"description":"The advertiser timezone.\n- America/Anchorage\n- America/Caracas\n- America/Chicago\n- America/Denver\n- America/Halifax\n- America/Los_Angeles\n- America/New_York\n- America/Sao_Paulo\n- America/St_Johns\n- As...","type":"string"}},"securitySchemes":{"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":{"advertising::campaign_management":"Modify your DSP advertising campaigns and access performance data"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"title":"Amazon Ads API for DSP","version":"3.0"},"openapi":"3.0.2","paths":{"/dsp/advertisers":{"get":{"description":"Returns a list of advertisers with information which satisfy the filtering criteria.","parameters":[{"description":"The client identifier of the customer making the request.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use GET method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"Sets a cursor into the requested set of advertisers. Use in conjunction with the count parameter to control pagination of the returned array. 0-indexed record offset for the result set, defaults to 0.","in":"query","name":"startIndex","schema":{"default":0,"format":"int32","maximum":29900,"type":"integer"}},{"description":"Sets the number of advertisers to be returned in a single call. Maximum of 100 advertisers per call.","in":"query","name":"count","schema":{"default":100,"format":"int32","maximum":100,"minimum":1,"type":"integer"}},{"description":"List of comma separated advertiser ids to filter the advertisers. If no advertiser ids provided, all advertisers in this entity will be returned.","example":"6753579448901,8753890875385","in":"query","name":"advertiserIdFilter","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspAdvertisersV1"}}},"description":"Successful operation"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Bad Request."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Unauthenticated request."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Forbidden - Request failed because user is not authorized to access a resource."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Not Found - Requested resource does not exist or is not visible for the authenticated user."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Unprocessable entity - Failed due to invalid parameters."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Internal Server Error."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Bad Gateway Exception."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Service Unavailable Exception."},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Endpoint Request Timed-out Exception."}},"tags":["Advertiser"]}},"/dsp/advertisers/{advertiserId}":{"get":{"description":"Returns advertiser information based on given advertiser id.","parameters":[{"description":"The client identifier of the customer making the request.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use GET method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"Unique id to identify advertiser","in":"path","name":"advertiserId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspAdvertiserV1"}}},"description":"Successful operation"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Bad Request."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Unauthenticated request."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Forbidden - Request failed because user is not authorized to access a resource."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Not Found - Requested resource does not exist or is not visible for the authenticated user."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Unprocessable entity - Failed due to invalid parameters."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Internal Server Error."},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Bad Gateway Exception."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Service Unavailable Exception."},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspErrorV1"}}},"description":"Endpoint Request Timed-out Exception."}},"tags":["Advertiser"]}}},"tags":[{"name":"Advertiser"}]}