ads_list_targetable_entities
List what a sponsored-ads campaign can target in the store's Ads account (Amazon's Discovery API).
readAmazon Adsads.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
In an AI client (MCP)
{
"name": "ads_list_targetable_entities",
"arguments": {
"store": "myStore-US",
"country_code": "<country_code>",
"ad_product": "SPONSORED_BRANDS"
}
}From code (Tool API)
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"}'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. |
country_coderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
ad_productrequired | string | the campaign type the entities are for. Allowed: SPONSORED_BRANDS | SPONSORED_DISPLAY | SPONSORED_PRODUCTS | SPONSORED_TELEVISION.SPONSORED_BRANDSSPONSORED_DISPLAYSPONSORED_PRODUCTSSPONSORED_TELEVISION |
target_type_filter | string[] | entity types; default ['AUDIENCE']. Allowed: AUDIENCE | CONTENT_CATEGORY | PRODUCT_CATEGORY | PRODUCT_CATEGORY_AUDIENCE.AUDIENCECONTENT_CATEGORYPRODUCT_CATEGORYPRODUCT_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.ar_AEde_DEen_AEen_AUen_CAen_GBen_INen_SGen_USen_ZAes_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:
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.