Amazon Ads API MCP

{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"insightsAudiencesOverlapAudienceMetadataV2":{"description":"Information about any audience included in the response.","properties":{"audienceForecast":{"properties":{"dailyImpressions":{"description":"The available impressions across all inventory types (e.g. display, video, and mobile). This is an estimate and is not guaranteed. It will take at least 2 weeks for the impressions to become available for new audiences. Note: forecasted daily impressions are not available when SD adType is selected.","properties":{"lowerBound":{"type":"integer"},"upperBound":{"type":"integer"}},"type":"object"},"dailyReach":{"description":"The unique devices reachable across all inventory types (e.g. display, video, and mobile). This is an estimate and is not guaranteed. It will take at least 2 weeks for the reach to become available for new audiences.","properties":{"lowerBound":{"type":"integer"},"upperBound":{"type":"integer"}},"type":"object"}},"type":"object"},"audienceId":{"description":"The identifier of an audience.","type":"string"},"category":{"description":"The type of the overlapping audience.","type":"string"},"name":{"description":"Audience name","type":"string"}},"required":["audienceId","category","name"],"type":"object"},"insightsAudiencesOverlapEntryV2":{"description":"Contains information about the overlapping audiences and their affinity with the provided audience.","properties":{"affinity":{"description":"Affinity is a measure of how similar the overlapping audience is to the audience selected to generate the audience overlap insights. An affinity of 2 indicates that the overlapping audience is twice as likely to fall into the audience selected than the average audience on Amazon.","minimum":0,"type":"number"},"audienceMetadata":{"$ref":"#/components/schemas/insightsAudiencesOverlapAudienceMetadataV2"}},"type":"object"},"insightsError":{"description":"The error returned from the server.","properties":{"message":{"description":"Detailed information about the error that occurred.","type":"string"},"requestId":{"description":"A unique value generated by the server to identify the request.","type":"string"}},"required":["message","requestId"],"type":"object"}},"securitySchemes":{}},"info":{"title":"Insights","version":"3.0"},"openapi":"3.0.1","paths":{"/insights/audiences/{audienceId}/overlappingAudiences":{"get":{"description":"\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\",\"advertiser_campaign_view\"]","operationId":"insightsGetAudiencesOverlappingAudiences","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":"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":"The identifier of an audience.","in":"path","name":"audienceId","required":true,"schema":{"type":"string"}},{"description":"The advertising program.","in":"query","name":"adType","required":true,"schema":{"enum":["DSP","SD"],"type":"string"}},{"description":"The identifier of the advertiser you'd like to retrieve overlapping audiences for. This parameter is required for the DSP adType, but is optional for the SD adType.","in":"query","name":"advertiserId","schema":{"type":"string"}},{"description":"If specified, the affinities of all returned overlapping audiences will be at least the provided affinity.","in":"query","name":"minimumOverlapAffinity","schema":{"minimum":0,"type":"number"}},{"description":"If specified, the affinities of all returned overlapping audiences will be at most the provided affinity.","in":"query","name":"maximumOverlapAffinity","schema":{"minimum":0,"type":"number"}},{"description":"If specified, the categories of all returned overlapping audiences will be one of the provided categories.","explode":false,"in":"query","name":"audienceCategory","schema":{"items":{"type":"string"},"maxItems":20,"minItems":1,"type":"array"},"style":"form"},{"description":"Sets the maximum number of overlapping audiences in the response. This parameter is supported only for request to return `application/vnd.insightsaudiencesoverlap.v2+json`.","in":"query","name":"maxResults","schema":{"default":"30","maximum":500,"minimum":1,"type":"integer"}},{"description":"Token to be used to request additional overlapping audiences. If not provided, the top 30 overlapping audiences are returned. Note: subsequent calls must be made using the same parameters as used in previous requests.","in":"query","name":"nextToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/vnd.insightsaudiencesoverlap.v2+json":{"schema":{"description":"Contains metadata for the provided audience and its overlapping audiences.","properties":{"marketplace":{"description":"The locale used to generate the overlapping audiences.","type":"string"},"nextToken":{"description":"If present, there are more overlapping audiences than initially returned. Use this token to call the operation again and have the additional overlapping audiences returned. The token is valid for 8 hours from the initial request. Note: subsequent calls must be made using the same parameters as used in previous requests.","type":"string"},"overlappingAudiences":{"description":"The list of overlapping audiences.","items":{"$ref":"#/components/schemas/insightsAudiencesOverlapEntryV2"},"maxItems":500,"minItems":0,"type":"array"},"requestedAudienceMetadata":{"$ref":"#/components/schemas/insightsAudiencesOverlapAudienceMetadataV2"}},"required":["marketplace","overlappingAudiences","requestedAudienceMetadata"],"type":"object"}}},"description":"Successfully retrieved the overlapping audiences."},"400":{"content":{"application/vnd.insightserror.v1+json":{"schema":{"$ref":"#/components/schemas/insightsError"}}},"description":"Bad request - Failed to retrieve the overlapping audiences because the request parameters are not valid."},"403":{"content":{"application/vnd.insightserror.v1+json":{"schema":{"$ref":"#/components/schemas/insightsError"}}},"description":"Forbidden - Failed to retrieve the overlapping audiences because the user does not have access to the audience requested."},"404":{"content":{"application/vnd.insightserror.v1+json":{"schema":{"$ref":"#/components/schemas/insightsError"}}},"description":"Not Found – Overlapping audiences are not available for the audience requested."}},"summary":"Retrieves the top audiences that overlap with the provided audience.","tags":["Audience insights"]}}}}