ads_get_target_recommendations
Sponsored Display: up to 100 recommended product, category, audience or content-category targets (whichever typeFilter asks for), based on the ASINs/SKUs you advertise.
readAmazon Adsads.sd
Amazon Ads API · getTargetRecommendations · POST /sd/targets/recommendations Docs: https://advertising.amazon.com/API/docs/en-us/sponsored-display/3-0/openapi#tag/Targeting-Recommendations/operation/getTargetRecommendations
Call it
In an AI client (MCP)
{
"name": "ads_get_target_recommendations",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>",
"body": {}
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_get_target_recommendations \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>","body":{}}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
countryCoderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
bodyrequired | object | {tactic*: 'T00020'|'T00030', products*: [{asin}] (1-10000), typeFilter*: ['PRODUCT'|'CATEGORY'|'AUDIENCE'| 'CONTENT_CATEGORY'] (1-3)}. tactic T00020 is contextual targeting (products); T00030 is audiences or contextual (products, categories, refined categories, audiences). |
locale | string | the language of the returned names; omit for the profile's own. Allowed: ar_AE | de_DE | en_AE | en_AU | en_CA | en_GB | en_IN | en_SG | en_US | es_ES | es_MX | fr_CA | fr_FR | hi_IN | it_IT | ja_JP | ko_KR | nl_NL | pl_PL | pt_BR | sv_SE | ta_IN | th_TH | tr_TR | vi_VN | zh_CN.ar_AEde_DEen_AEen_AUen_CAen_GBen_INen_SGen_USes_ESes_MXfr_CAfr_FRhi_INit_ITja_JPko_KRnl_NLpl_PLpt_BRsv_SEta_INth_THtr_TRvi_VNzh_CN |
Result
Every tool answers {notification, data, human_action}; data carries:
- Amazon's payload in data.result.
Gotchas
- products accepts sku as well as asin (Amazon's schema documents only asin, but a seller may pass sku instead).
- Allow about a week for Amazon to have data on a newly listed ASIN.
- The response uses the legacy SD expression form ({type: 'asinSameAs', value: '<ASIN>'}) — ads_create_target does NOT accept that shape; translate before creating (adProduct SPONSORED_DISPLAY): asinSameAs -> targetType PRODUCT, targetDetails {productTarget: {matchType: PRODUCT_EXACT, product: {productId}, productIdType: ASIN}}; asinCategorySameAs -> targetType PRODUCT_CATEGORY, targetDetails {productCategoryTarget: {productCategoryRefinement: {productCategoryRefinement: {productCategoryId}}}} (the wrapper key is nested TWICE).