SP targeting options
get_sp_targeting_optionsReturn Amazon-source Sponsored Products targeting options and recommendation fields: keyword candidates, product target candidates, category recommendations/tree/refinements, and negative brand search/recommendations. Source-attributed read-only data; agentcentral does not decide which targets to create.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asins | No | Input ASINs for product/category recommendations | |
| cursor | No | Amazon cursor for product recommendation pagination | |
| locale | No | Optional Amazon Ads locale, such as en_US or de_DE | |
| themed | No | For product recommendations, request Amazon theme-grouped output when supported | |
| keyword | No | Brand search keyword for negative_brand_search | |
| profile_id | No | Numeric Amazon Ads profile ID. Optional when this API key has exactly one enabled Ads profile; agentcentral will default it. Call get_account_info for amazon_ads.enabled_profile_ids. Do not use the marketplace ID, tenant ID, or API key prefix. | |
| ad_group_id | No | Ad group ID for keyword recommendations | |
| campaign_id | No | Campaign ID for keyword recommendations | |
| category_id | No | Category ID for category_refinements | |
| max_results | No | Maximum Amazon-source options to request where supported | |
| option_type | Yes | Amazon-source targeting discovery surface to call | |
| include_ancestor | No | For category recommendations, include ancestor categories when Amazon supports it | |
| include_raw_rows | No | False returns compact rows. Default true. | |
| candidate_keywords | No | Optional keywords to rank alongside Amazon keyword recommendations | |
| include_diagnostics | No | True may add expanded freshness diagnostics. Basic empty-result data-window diagnostics are included by default when available. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| evidence | No |