# ads_get_category_recommendations_for_asins (https://sellersheetai.com/docs/mcp-api/tools/ads_get_category_recommendations_for_asins)

> Sponsored Products: category targets recommended for a list of ASINs — the coarse half of SP product targeting; narrow one further with ads_get_refinements_for_category.

Access: **READ** · toolset amazon_ads · family ads.sp

Amazon Ads API · getCategoryRecommendationsForASINs · POST /sp/targets/categories/recommendations Docs: https://advertising.amazon.com/API/docs/en-us/sponsored-products/3-0/openapi/prod#tag/Product-Targeting/operation/getCategoryRecommendationsForASINs

## Call it

MCP tool call:

```json
{
  "name": "ads_get_category_recommendations_for_asins",
  "arguments": {
    "store": "myStore-US",
    "countryCode": "<countryCode>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_get_category_recommendations_for_asins \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","countryCode":"<countryCode>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
| `countryCode` | string | yes | the Ads profile's 2-letter country code (e.g. 'US'). |
| `body` | object |  | {"asins": ["B0XXXXXXXX", ...], "includeAncestor": false} — includeAncestor optionally also returns ancestor categories (more results, less relevant). |
| `locale` | string |  | the language of the returned category names; omit for the marketplace's default language. 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. 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. |

## Result

- Amazon's payload in data.result.

## Gotchas

- Amazon 500s ("Failed to get category recommendations") for some ASIN/marketplace combinations — relayed as an Amazon error, not a SellerSheet bug. Do not retry-loop; try other ASINs or use ads_sp_get_product_recommendations instead.
- Only entries with canBeTargeted=true can be used as targets.
- Best practice: call ads_get_refinements_for_category on a chosen category id to get the brand / age-range / genre facets, then create the target with ads_create_target, targetType='PRODUCT_CATEGORY' and targetDetails={"productCategoryTarget": {"productCategoryRefinement": { "productCategoryRefinement": {"productCategoryId": "<id>"}}}} (productCategoryRefinement is nested TWICE — the outer key is the wrapper, the inner one holds the fields).