Get Audience Estimate

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

Get Started

Guides

Operations

Get Audience Estimate

Inputs

SelectableOption

Output

​Inputs

​SelectableOption

​Output

Inputs

SelectableOption

Output