Amazon Ads API MCP

{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"GsbTargetKpiRecommendationErrorMessage":{"type":"string"},"GsbTargetKpiRecommendationException":{"properties":{"message":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationErrorMessage"}},"type":"object"},"GsbTargetKpiRecommendationRequest":{"properties":{"advertiserCountry":{"description":"The name of the country associated with the advertiser.","type":"string"},"advertiserId":{"description":"The identifier of the advertiser.","type":"string"},"advertiserIndustry":{"description":"The industry or sector of the advertiser.","type":"string"},"budgetAmount":{"description":"Budget amount set by the user. Will be null in case of Pre-Budget scenario.","type":"number"},"currencyCode":{"description":"The currency code (e.g., USD, EUR) used for the budget.","type":"string"},"entityId":{"description":"The identifier of the entity.","type":"string"},"flightEndDate":{"description":"The campaign flight end date in YYYY-MM-DD format.","format":"date","type":"string"},"flightStartDate":{"description":"The campaign flight start date in YYYY-MM-DD format.","format":"date","type":"string"},"goalKpi":{"description":"The key performance indicator (KPI) for the campaign.","type":"string"}},"required":["advertiserId","currencyCode","entityId","flightEndDate","flightStartDate","goalKpi"],"type":"object"},"GsbTargetKpiRecommendationResponse":{"properties":{"currencyCode":{"description":"The currency code of the recommended KPI value.","type":"string"},"goalKpi":{"description":"The key performance indicator (KPI) for the campaign.","type":"string"},"modelBasedRecommendation":{"description":"Boolean value to signify if recommendation was generated by the model or by a heuristic.","type":"boolean"},"recommendedKpi":{"$ref":"#/components/schemas/RecommendedKpi"}},"required":["currencyCode","goalKpi","modelBasedRecommendation","recommendedKpi"],"type":"object"},"RecommendedKpi":{"description":"Nested object that contains the lower and upper bound of the recommendation range.","properties":{"lowerBound":{"description":"Lower bound of recommendation range.","type":"number"},"upperBound":{"description":"Upper bound of recommendation range.","type":"number"}},"required":["lowerBound","upperBound"]}},"securitySchemes":{}},"info":{"title":"Goal Seeking Bidder Target KPI Recommendation","version":"3.0"},"openapi":"3.0.1","paths":{"/dsp/campaigns/targetKpi/recommendations":{"post":{"description":"Creates a Target KPI recommendation for advertisers when they are in the process of creating a new campaign (ADSP).","operationId":"getGsbTargetKpiRecommendation","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","explode":false,"in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"},"style":"simple"},{"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 and choose profile id `profileId` from the response to pass it as input.","explode":false,"in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"},"style":"simple"}],"requestBody":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationRequest"}}}},"responses":{"200":{"content":{"application/vnd.spinitialbudgetrecommendation.v3.4+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationResponse"}}},"description":"200 response."},"400":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"400 response."},"401":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"401 response."},"403":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"403 response."},"404":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"404 response."},"422":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"422 response."},"429":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"429 response."},"500":{"content":{"application/vnd.gsbtargetkpirecommendation.v1+json":{"schema":{"$ref":"#/components/schemas/GsbTargetKpiRecommendationException"}}},"description":"500 response."}}}}}}