account | DynamicAccount | Yes | - | Select the Pinterest Ads account whose ads should be listed. |
campaign_ids | array of string (also accepts a comma-separated string) | No | - | Optional campaign IDs to list ads from, as a list or comma-separated text. |
ad_group_ids | array of string (also accepts a comma-separated string) | No | - | Optional ad group IDs to list ads from, as a list or comma-separated text. |
ad_ids | array of string (also accepts a comma-separated string) | No | - | Optional ad IDs to fetch, as a list or comma-separated text. |
entity_statuses | array of string or SelectableOption | No | - | Filter ads by status. Options: ACTIVE, PAUSED, ARCHIVED, DRAFT. Defaults to ACTIVE and PAUSED when omitted. |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving ads. The available fields to filter by are: - id: Filter by ad ID - name: Filter by ad name - ad_group_id: Filter by parent ad group ID - campaign_id: Filter by parent campaign ID 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. |
