Recommendation Types

Amazon Ads API v1 - recommendation types for Sponsored Brands

Documentation: https://advertising.amazon.com/API/docs/en-us/api-spec-v1-recommendation-types Specification: https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIALLRecommendationTypesContract_prod_3p.json

One route, read only, and the product is in the path:

POST /adsApi/v1/query/recommendationTypes/sb

This family lists the kinds of recommendation that exist. Recommendations itself lists the ones the account actually has.

Only the Sponsored Brands segment is published, and its schemas are prefixed SB (SBQueryRecommendationTypeRequest, SBRecommendationType). The route keeps no SB in its name, so another product would arrive as .../sp or .../sd beside it.

Every member of the request is optional, so an empty body is valid and asks for the defaults. maxResults accepts 50 to 500 and starts at 50, so a smaller value is a rejected body rather than a shorter page.

class ad_api.api.v1.RecommendationTypes(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, debug=False)

Amazon Ads API v1 - recommendation types for Sponsored Brands

One route, read only, and the product is in the path:

POST /adsApi/v1/query/recommendationTypes/sb

This family lists the kinds of recommendation that exist. Recommendations itself, in ad_api.api.v1.Recommendations, lists the ones the account actually has.

Only the Sponsored Brands segment is published, and its schemas are prefixed SB. The route keeps no SB in its name, so another product would arrive as …/sp or …/sd beside it.

query_sb_recommendation_types(body: dict) → ApiResponse

Amazon Ads API v1 - Query SB Recommendation Types (operationId: SBQueryRecommendationType)

Request Body [All optional]: maxResults (int) : 50..500, default 50

nextToken (string) : token to navigate to the next page
Returns: recommendationTypes (list<SBRecommendationType>) : 0..500 | recommendationTypeId (string) : [required] a UUID or a unique descriptive string | recommendationTypeTitle (string) : [required]

nextToken (string)

maxResults starts at 50, so a smaller value is a rejected body rather than a shorter page. An empty body is valid and asks for the defaults.

Requires one of these permissions:: advertiser_campaign_view