> ## 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.

# Get Audience Estimate

> Estimate the audience size (monthly active people) Meta can reach with a targeting spec, before creating any audience or ad set

Estimate the audience size (monthly active people) Meta can reach with a targeting spec, before creating any audience or ad set. Use it to size or compare targeting options; nothing is created.

| | |
| - | - |
| **App** | Meta Ads |
| **Operation ID** | `meta_ads_get_audience_estimate` |
| **Type** | Action |
| **Connection** | `meta_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | DynamicAccount | Yes | - | The Meta Ads account to estimate for |
| `targeting` | object or string | Yes | - | The Meta targeting spec to size, as a JSON object sent to Meta as-is, in the same shape as an ad set's targeting. It needs at least one location (geo\_locations) or custom audience. Look up interest, behavior and location ids with meta\_ads\_search\_targeting. Example: \{"geo\_locations": \{"countries": \["GR"]}, "age\_min": 25, "age\_max": 55, "interests": \[\{"id": "6003107902433", "name": "Yoga"}]} |
| `optimization_goal` | string or SelectableOption | No | - | The ad set optimization goal to estimate for, default REACH. |
| `promoted_object` | object or string | No | - | Optional promoted\_object of the planned ad set, in Meta's ad set format, e.g. \{"pixel\_id": "1234567890", "custom\_event\_type": "PURCHASE"} for a conversions goal. |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `Dict`

Returns Meta's estimate: estimate\_mau\_lower\_bound and estimate\_mau\_upper\_bound (monthly active people), estimate\_ready (false while Meta is still computing it; run again shortly) and targeting\_optimization\_types when Meta reports them.

**Fields**: `estimate_mau_lower_bound`, `estimate_mau_upper_bound`, `estimate_ready`, `targeting_optimization_types`


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