Skip to content
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_id
    string [uuid]
    Required
  • bid_micro_amount
    integer [int64]
    Required
    Example value: 12000000
  • bid_optimization_goal
    string [bid-optimization-goal]
    Required
    Example value: "AD_COMPLETES"Allowed values: "UNSET", "AD_COMPLETES", "CLICKS", "EVEN_IMPRESSION_DELIVERY", "REACH"
  • budget_micro_amount
    integer [int64]
    Required
    Example value: 300000000
  • Required
  • start_date
    string [date-time]
    Required
    Example value: "2022-11-06T14:00:00Z"
  • end_date
    string [date-time]
    Required
    Example value: "2022-11-10T14:00:00Z"

Response

  • estimated_ads_served_max
    integer [int64]
    Example value: 5
  • estimated_ads_served_min
    integer [int64]
    Example value: 1
  • estimated_reach_max
    integer [int64]
    Example value: 5
  • estimated_reach_min
    integer [int64]
    Example value: 1

Response sample

{  "estimated_ads_served_max": 5,  "estimated_ads_served_min": 1,  "estimated_reach_max": 5,  "estimated_reach_min": 1}