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

> List what a sponsored-ads campaign can target in the store's Ads account (Amazon's Discovery API).

Access: **READ** · toolset amazon_ads · family ads.targetable-entities

By default it lists the store's AMC audiences — the audienceId a Sponsored Products / Brands audience bid adjustment or a Sponsored Display target takes. Amazon Ads API · ListTargetableEntities · POST /targetableEntities/list Docs: https://advertising.amazon.com/API/docs/en-us/targetable-entities#operation/ListTargetableEntities

## Call it

MCP tool call:

```json
{
  "name": "ads_list_targetable_entities",
  "arguments": {
    "store": "myStore-US",
    "country_code": "<country_code>",
    "ad_product": "SPONSORED_BRANDS"
  }
}
```

Tool API (early access — contact us):

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

## 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. |
| `country_code` | string | yes | the Ads profile's 2-letter country code (e.g. 'US'). |
| `ad_product` | string | yes | the campaign type the entities are for. Allowed: SPONSORED_BRANDS \| SPONSORED_DISPLAY \| SPONSORED_PRODUCTS \| SPONSORED_TELEVISION. Allowed: SPONSORED_BRANDS \| SPONSORED_DISPLAY \| SPONSORED_PRODUCTS \| SPONSORED_TELEVISION. |
| `target_type_filter` | string[] |  | entity types; default ['AUDIENCE']. Allowed: AUDIENCE \| CONTENT_CATEGORY \| PRODUCT_CATEGORY \| PRODUCT_CATEGORY_AUDIENCE. Allowed: AUDIENCE \| CONTENT_CATEGORY \| PRODUCT_CATEGORY \| PRODUCT_CATEGORY_AUDIENCE. |
| `paths_filter` | object[] |  | taxonomy paths to list under; default [['Audience Category', 'Custom-built', 'AMC']] (the AMC audiences). |
| `search_query_filter` | string |  | words to search the entities for. |
| `max_results` | integer · 1–250 |  | entities per page. |
| `next_token` | string |  | the cursor from the previous call's data.nextToken; omit for the first page. |
| `locale` | string |  | names in this locale, e.g. 'en_AE'. Allowed: ar_AE \| de_DE \| en_AE \| en_AU \| en_CA \| en_GB \| en_IN \| en_SG \| en_US \| en_ZA \| 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 \| en_ZA \| 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

- `data.targetable_entities[]` — Amazon's entities — {audienceId, audienceResolved, path, targetType, …}.
- `data.nextToken` — set when more entities remain.

## Body (Amazon schema)

- adProduct*: SPONSORED_BRANDS | SPONSORED_DISPLAY | SPONSORED_PRODUCTS | SPONSORED_TELEVISION locale: ar_AE | de_DE | en_AE | en_AU | en_CA | en_GB | en_IN | en_SG | en_US | en_ZA | 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 maxResults: number (1–250) nextToken: string parentBrowseNodeIdFilter: [string] (max 1000) pathsFilter: [[string] (max 10)] (max 10) productCategoryIdFilter: [string] (max 1000) searchQueryFilter: string targetTypeFilter: [AUDIENCE | CONTENT_CATEGORY | PRODUCT_CATEGORY | PRODUCT_CATEGORY_AUDIENCE] (max 4)

## Gotchas

- An AMC audience appears here 2–24 hours after it SUCCEEDED.