account | DynamicAccount | Yes | - | Select the X Ads account to report on. |
entity_type | enum (CAMPAIGN, FUNDING_INSTRUMENT) | No | CAMPAIGN | What to measure reach for: CAMPAIGN (default) or FUNDING_INSTRUMENT. Reach and average frequency are only available at these two levels. |
entity_ids | string or array of string | Yes | - | Campaign or funding instrument IDs to measure (list or comma-separated, up to 20 per run). |
time_range | string or SelectableOption | No | {'value': 'last_7_days', 'label': 'Last 7 days'} | Period to measure: ‘last_7_days’ (default), ‘last_3_days’, ‘today’, or ‘yesterday’. X caps reach windows at 7 days. |