account | DynamicAccount | Yes | - | Select the Amazon Ads profile whose ads should be listed. |
ad_products | array of string or SelectableOption | No | - | Filter ads by ad product. Options: SPONSORED_PRODUCTS, SPONSORED_BRANDS, SPONSORED_DISPLAY, SPONSORED_TELEVISION. Defaults to all four when omitted. |
entity_states | array of string or SelectableOption | No | - | Filter ads 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 ads 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 ads for, as a list or comma-separated text. Up to 100. |
ad_ids | array of string (also accepts a comma-separated string) | No | - | Optional ad IDs to fetch, as a list or comma-separated text. Up to 100. |
name_contains | string | No | - | Optional name filter: returns ads whose name matches the given text (Amazon broad match). |
filters | array of FilterItem | No | - | Additional filters to apply after retrieving ads. The available fields to filter by are: - adId: Filter by ad ID - adGroupId: Filter by ad group ID - campaignId: Filter by campaign ID - adType: Filter by ad type - name: Filter by ad name - state: Filter by ad 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 ads to return. Default: 100. |
