> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forecast Audience

> Estimates Reddit audience size and weekly delivery (impressions, clicks, conversions, reach) for a planned ad group's objective, budget, bidding and targeting before launching

Estimates Reddit audience size and weekly delivery (impressions, clicks, conversions, reach) for a planned ad group's objective, budget, bidding and targeting before launching. Read-only; creates nothing.

| | |
| - | - |
| **App** | Reddit Ads |
| **Operation ID** | `reddit_ads_forecast_audience` |
| **Type** | Action |
| **Connection** | `reddit_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | DynamicAccount | Yes | - | Select the Reddit Ads account to forecast for. |
| `objective` | enum (`APP_INSTALLS`, `BRAND_AWARENESS`, `CATALOG_SALES`, `CLICKS`, `CONVERSIONS`, `IMPRESSIONS`, `LEAD_GENERATION`, `SALES`, ...) | Yes | - | Campaign objective to forecast, e.g. LEAD\_GENERATION. |
| `goal_value` | number | Yes | - | Ad group budget in the account currency (converted to microcurrency automatically), daily or lifetime per goal\_type. |
| `goal_type` | enum (`DAILY_SPEND`, `LIFETIME_SPEND`) | No | - | Budget type. Default: DAILY\_SPEND. |
| `bid_strategy` | string | Yes | - | BIDLESS (Lowest Cost), MANUAL\_BIDDING, MAXIMIZE\_VOLUME (Cost Cap) or TARGET\_CPX. |
| `bid_type` | string | Yes | - | CPC, CPM, CPV, CPV6 or CPV15, matching the objective (e.g. LEAD\_GENERATION accepts CPC or CPM). |
| `bid_value` | number | No | - | Bid in the account currency (converted to microcurrency automatically). |
| `optimization_goal` | string | No | - | Event to optimize for, e.g. LEAD, PURCHASE, SIGN\_UP, PAGE\_VISIT. |
| `start_time` | string | No | - | Planned start, ISO 8601 or YYYY-MM-DD. |
| `end_time` | string | No | - | Planned end, ISO 8601 or YYYY-MM-DD. |
| `targeting` | object or string | No | - | Reddit Ads v3 ad group targeting object, sent as-is (same as reddit\_ads\_create\_ad\_group). Example: \{"geolocations": \["NZ"], "communities": \["newzealand", "auckland"], "platforms": \["MOBILE\_NATIVE"], "expand\_targeting": true}. |

## Output

**Type**: `Dict`

Returns target\_audience\_range (min/max people over 30 days) and delivery\_estimates (weekly min/max impressions, clicks, video\_views, conversions, reach, installs).

**Fields**: `target_audience_range`, `delivery_estimates`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.