Ads API •References / Estimate / Get Audience Estimate
Get Audience Estimate
Returns an audience estimate (min and max impressions and reach) based on specific ad set parameters.
Request
- ad_account_idstring [uuid]Required
- bid_micro_amountinteger [int64]RequiredExample value:
12000000
- bid_optimization_goalstring [bid-optimization-goal]RequiredExample value:
"AD_COMPLETES"
Allowed values:"UNSET"
,"AD_COMPLETES"
,"CLICKS"
,"EVEN_IMPRESSION_DELIVERY"
,"REACH"
- budget_micro_amountinteger [int64]RequiredExample value:
300000000
- Required
- start_datestring [date-time]RequiredExample value:
"2022-11-06T14:00:00Z"
- end_datestring [date-time]RequiredExample value:
"2022-11-10T14:00:00Z"
Response
- estimated_ads_served_maxinteger [int64]Example value:
5
- estimated_ads_served_mininteger [int64]Example value:
1
- estimated_reach_maxinteger [int64]Example value:
5
- estimated_reach_mininteger [int64]Example value:
1
Response sample
{ "estimated_ads_served_max": 5, "estimated_ads_served_min": 1, "estimated_reach_max": 5, "estimated_reach_min": 1}