account | DynamicAccount | Yes | - | Select the Amazon Ads profile whose targets should be listed. |
ad_products | array of string or SelectableOption | No | - | Filter targets by ad product. Options: SPONSORED_PRODUCTS, SPONSORED_BRANDS, SPONSORED_DISPLAY, SPONSORED_TELEVISION. Defaults to all four when omitted. |
target_types | array of string or SelectableOption | No | - | Filter by target type: KEYWORD, PRODUCT, PRODUCT_CATEGORY, PRODUCT_AUDIENCE, THEME, AUDIENCE. Returns all types when omitted. |
negative | string or SelectableOption | No | {'value': 'all', 'label': 'All'} | Filter by negative flag: all (default), positive (targeting), or negative (exclusions). |
entity_states | array of string or SelectableOption | No | - | Filter targets by state. Options: ENABLED, PAUSED, ARCHIVED, DRAFT, PROPOSED. Defaults to ENABLED and PAUSED when omitted. |
campaign_ids | array of string (also accepts a comma-separated string) | No | - | Optional campaign IDs to list targets for, as a list or comma-separated text. Up to 100. |
ad_group_ids | array of string (also accepts a comma-separated string) | No | - | Optional ad group IDs to list targets for, as a list or comma-separated text. Up to 100. |
target_ids | array of string (also accepts a comma-separated string) | No | - | Optional target IDs to fetch, as a list or comma-separated text. Up to 100. |
keywords | array of string (also accepts a comma-separated string) | No | - | Optional keyword texts to filter keyword targets by, as a list or comma-separated text. Up to 100. |
filters | array of FilterItem | No | - | Additional filters to apply after retrieving targets. The available fields to filter by are: - targetId: Filter by target ID - adGroupId: Filter by ad group ID - campaignId: Filter by campaign ID - targetType: Filter by target type - state: Filter by target state Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST. |
limit | integer | No | 100 | Maximum number of targets to return. Default: 100. |