Amazon Ads API MCP

{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"AdvertiserReportMetadata":{"properties":{"advertiserId":{"type":"string"},"indexDate":{"pattern":"^[0-9]{4}-(0*[1-9]|1[0-2])-(0*[1-9]|[1-2][0-9]|3[0-1])$","type":"string"},"obfuscatedMarketplaceId":{"type":"string"},"reportType":{"type":"string"}},"type":"object"},"BadRequestExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"ConflictExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"ForbiddenExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"GetAdvertiserReportResponseContent":{"description":"The presigned S3 URL to allow clients to download the report.","properties":{"downloadLink":{"type":"string"}},"type":"object"},"InternalServerExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"ListAdvertiserReportMetadataResponseContent":{"description":"The presigned S3 URL to allow clients to download the report.","properties":{"nextToken":{"type":"string"},"reportsMetadata":{"items":{"$ref":"#/components/schemas/AdvertiserReportMetadata","properties":{}},"maxItems":1000,"minItems":0,"type":"array"}},"type":"object"},"ResourceNotFoundExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"SubErrorV1":{"properties":{"errorType":{"type":"string"},"fieldName":{"type":"string"},"message":{"type":"string"}},"required":["errorType","message"],"type":"object"},"TooManyRequestsExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"UnauthorizedExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"UnsupportedMediaTypeExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/SubErrorV1","properties":{}},"maxItems":5,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"}},"securitySchemes":{}},"info":{"title":"Brand Benchmarks","version":"3.0"},"openapi":"3.0.1","paths":{"/insights/brandBenchmarks/advertisers/{advertiserId}/allReportMetadata":{"get":{"description":"Gets all of the report metadata the specified advertiser at the specified marketplace.\n\n**Authorized resource type**:\nGlobal Manager Account ID\n\n**Parameter name**:\nAmazon-Advertising-API-Manager-Acco...","operationId":"ListAdvertiserReportMetadata","parameters":[{"in":"path","name":"advertiserId","required":true,"schema":{"type":"string"}},{"in":"query","name":"nextToken","schema":{"type":"string"}},{"in":"query","name":"maxResults","schema":{"type":"number"}},{"description":"For 3P calls this value will be true by default. Otherwise, if false, this will return all report metadata.","in":"query","name":"latestOnly","schema":{"description":"For 3P calls this value will be true by default. Otherwise, if false, this will return all report metadata.","type":"boolean"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The Manager Account ID which is accessible from the\n[Manager Accounts List](https://advertising.amazon.com/am/managerAccounts/list).","in":"header","name":"Amazon-Advertising-API-Manager-Account","required":true,"schema":{"description":"The Manager Account ID which is accessible from the\n[Manager Accounts List](https://advertising.amazon.com/am/managerAccounts/list).","type":"string"}}],"responses":{"200":{"content":{"application/vnd.insightsAdvertiser.v1+json":{"schema":{"$ref":"#/components/schemas/ListAdvertiserReportMetadataResponseContent"}}},"description":"ListAdvertiserReportMetadata 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestExceptionV1ResponseContent"}}},"description":"BadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionV1ResponseContent"}}},"description":"UnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenExceptionV1ResponseContent"}}},"description":"ForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionV1ResponseContent"}}},"description":"ResourceNotFoundExceptionV1 404 response"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictExceptionV1ResponseContent"}}},"description":"ConflictExceptionV1 409 response"},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionV1ResponseContent"}}},"description":"UnsupportedMediaTypeExceptionV1 415 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsExceptionV1ResponseContent"}}},"description":"TooManyRequestsExceptionV1 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionV1ResponseContent"}}},"description":"InternalServerExceptionV1 500 response"}},"tags":["Brand Benchmarks"]}},"/insights/brandBenchmarks/advertisers/{advertiserId}/reports/{reportType}/indexDates/{indexDate}":{"get":{"description":"Gets the download link for an advertiser's metric report in the specified marketplace.\n\n**Authorized resource type**:\nGlobal Manager Account ID\n\n**Parameter name**:\nAmazon-Advertising-API-Manager-Acco...","operationId":"GetAdvertiserReport","parameters":[{"in":"path","name":"advertiserId","required":true,"schema":{"type":"string"}},{"in":"path","name":"indexDate","required":true,"schema":{"pattern":"^[0-9]{4}-(0*[1-9]|1[0-2])-(0*[1-9]|[1-2][0-9]|3[0-1])$","type":"string"}},{"in":"path","name":"reportType","required":true,"schema":{"type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The Manager Account ID which is accessible from the\n[Manager Accounts List](https://advertising.amazon.com/am/managerAccounts/list).","in":"header","name":"Amazon-Advertising-API-Manager-Account","required":true,"schema":{"description":"The Manager Account ID which is accessible from the\n[Manager Accounts List](https://advertising.amazon.com/am/managerAccounts/list).","type":"string"}}],"responses":{"200":{"content":{"application/vnd.insightsAdvertiser.v1+json":{"schema":{"$ref":"#/components/schemas/GetAdvertiserReportResponseContent"}}},"description":"GetAdvertiserReport 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestExceptionV1ResponseContent"}}},"description":"BadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionV1ResponseContent"}}},"description":"UnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenExceptionV1ResponseContent"}}},"description":"ForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionV1ResponseContent"}}},"description":"ResourceNotFoundExceptionV1 404 response"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictExceptionV1ResponseContent"}}},"description":"ConflictExceptionV1 409 response"},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionV1ResponseContent"}}},"description":"UnsupportedMediaTypeExceptionV1 415 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsExceptionV1ResponseContent"}}},"description":"TooManyRequestsExceptionV1 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionV1ResponseContent"}}},"description":"InternalServerExceptionV1 500 response"}},"tags":["Brand Benchmarks"]}}}}