Recommendations

class ad_api.api.sd.Recommendations(account: str = 'default', marketplace: Marketplaces = Marketplaces.EU, credentials: Dict[str, str] | None = None, proxies: Dict[str, str] | None = None, verify: bool = True, timeout: int | None = None, debug: bool = False, access_token: str | None = None, verify_additional_credentials: bool = True)

Endpoints available

Method	Endpoint	Description
POST	/sd/recommendations/creative/headline	Retrieve creative headline recommendations.

list_headline_recommendations(self, **kwargs) → ApiResponse:

You can use this Sponsored Display API to retrieve creative headline recommendations from an array of ASINs.

Request Body

SDHeadlineRecommendationRequest {

Request structure of SD headline recommendation API.

asins (array) minItems: 0 maxItems: 100 [

(string) An array of ASINs associated with the creative.

]

maxNumRecommendations (array) Maximum number of recommendations that API should return. Response will [0, maxNumRecommendations] recommendations (recommendations are not guaranteed as there can be instances where the ML model can not generate policy compliant headlines for the given set of asins). maximum: 10. minimum: 1 .

adFormat (string): Enum: [ SPONSORED_DISPLAY ]

}

Returns

ApiResponse

list_headline_recommendations(**kwargs)

You can use this Sponsored Display API to retrieve creative headline recommendations from an array of ASINs.

Request Body

SDHeadlineRecommendationRequest {

Request structure of SD headline recommendation API.

asins (array) minItems: 0 maxItems: 100 [

(string) An array of ASINs associated with the creative.

]

maxNumRecommendations (array) Maximum number of recommendations that API should return. Response will [0, maxNumRecommendations] recommendations (recommendations are not guaranteed as there can be instances where the ML model can not generate policy compliant headlines for the given set of asins). maximum: 10. minimum: 1 .

adFormat (string): Enum: [ SPONSORED_DISPLAY ]

}

Returns

ApiResponse