account | DynamicAccount | Yes | - | Select the X Ads account whose custom audiences should be listed. |
audience_ids | string or array of string | No | - | Scope to specific audience IDs (list or comma-separated string, up to 200). |
q | string | No | - | Scope audiences by name (case-insensitive prefix match, so it matches names that start with this text). |
permission_scope | enum (OWNER, SHARED) | No | - | OWNER (default) lists the account’s own audiences; SHARED lists audiences shared with it. |
sort_by | string | No | - | Sort by a supported attribute, e.g. ‘created_at-desc’ or ‘updated_at-asc’. |
with_deleted | boolean | No | False | Include deleted audiences. |
filters | array of FilterItem | No | - | Additional filters applied to the returned audiences. The available fields to filter by are: - id: Filter by audience ID - name: Filter by audience name - audience_type: Filter by type (CRM, WEB, MOBILE_AUDIENCE, FLEXIBLE) - targetable: Filter by whether the audience can be targeted (true/false) 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 audiences to return. Default: 100. |
