account | DynamicAccount | Yes | - | Select the Spotify Ads account whose ad sets should be listed. |
campaign_id | string or SelectItem | No | - | Only list ad sets in this campaign. Lists all ad sets in the account when omitted. |
entity_statuses | array of string or SelectableOption | No | - | Filter ad sets by status: ACTIVE, ACTIVE_RESTRICTED, APPROVED, ARCHIVED, COMPLETED, PENDING_APPROVAL, READY, REJECTED. Returns all statuses when omitted. |
draft_filter | enum (PUBLISHED_ONLY, INCLUDE_DRAFTS, DRAFTS_ONLY) | No | PUBLISHED_ONLY | Which records to return: PUBLISHED_ONLY (default, live ad sets), INCLUDE_DRAFTS (published plus drafts from the Spotify drafts endpoint, with every row flagged by is_draft), or DRAFTS_ONLY. |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving ad sets. The available fields to filter by are: - id: Filter by ad set ID - name: Filter by ad set name - 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 ad sets to return. Default: 100. |