account | DynamicAccount | Yes | - | Select Meta Ads account, ask the user for it if not provided |
campaign_effective_status | array of string or SelectableOption | No | - | Filter ads by parent campaign effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES |
adset_effective_status | array of string or SelectableOption | No | - | Filter ads by parent ad set effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, CAMPAIGN_PAUSED, ARCHIVED, IN_PROCESS, WITH_ISSUES |
ad_effective_status | array of string or SelectableOption | No | - | Filter ads by ad effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving ads. The available fields to filter by are: - campaign_id: Filter by parent campaign ID - campaign_name: Filter by parent campaign name - adset_id: Filter by parent ad set ID - adset_name: Filter by parent ad set name - ad_id: Filter by ad ID - ad_name: Filter by ad name 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 | 500 | Maximum number of ads to return (1-1000) |
response_format | enum (flattened, raw) | No | flattened | Shape of the returned ads. ‘flattened’ (default) flattens nested Meta objects into top-level fields (for example campaign_id, adset_name, creative_image_url). ‘raw’ returns Meta’s response untouched, with campaign, adset, and creative kept as nested objects. Status and client-side filters work the same in both modes. |
