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

> List the taxonomy paths under which ads_list_targetable_entities finds entities (Amazon's Discovery API): the direct sub-paths of each path in paths_filter, or the top level.

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

Amazon Ads API · ListTargetableEntityPaths · POST /targetableEntities/paths/list Docs: https://advertising.amazon.com/API/docs/en-us/targetable-entities#operation/ListTargetableEntityPaths

## Call it

MCP tool call:

```json
{
  "name": "ads_list_targetable_entity_paths",
  "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_entity_paths \
  -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 paths are for. Allowed: SPONSORED_BRANDS \| SPONSORED_DISPLAY \| SPONSORED_PRODUCTS \| SPONSORED_TELEVISION. Allowed: SPONSORED_BRANDS \| SPONSORED_DISPLAY \| SPONSORED_PRODUCTS \| SPONSORED_TELEVISION. |
| `paths_filter` | object[] |  | paths to list the children of, each a list of names, e.g. [['Audience Category']]; omit for the top level. |
| `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.paths[]` — the sub-paths, each a list of names — pass one to ads_list_targetable_entities' paths_filter.
- `data.total_results` — how many paths Amazon has there.