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: 12000000
  • bid_optimization_goal
    string [bid-optimization-goal]
    Required
    Allowed values: "UNSET", "EVEN_IMPRESSION_DELIVERY", "REACH", "AD_COMPLETES"Example: "AD_COMPLETES"
  • budget_micro_amount
    integer [int64]
    Required
    Example: 300000000
    • frequency_unit
      string [frequency-cap-frequency-unit]
      Allowed values: "DAY", "MONTH", "WEEK"Example: "DAY"
    • frequency_period
      integer [int32]
      Example: 1
    • max_impressions
      integer [int32]
      Example: 2
  • Required
      • max
        integer
        Required
        Range: 13 - 65Example: 65
      • min
        integer
        Required
        Range: 13 - 65Example: 13
    • artist_ids
      array of strings
    • city_ids
      array of integers
    • country_codes
      array of strings
      Example: "US"
    • dma_ids
      array of integers
    • gender_names
      array of Gender
      Allowed values: "MALE", "FEMALE", "NON_BINARY"Example: "MALE"
    • genre_ids
      array of strings
    • platform_names
      array of Platform
      Allowed values: "IOS", "DESKTOP", "ANDROID", "OTHER"Example: "IOS"
    • playlist_ids
      array of strings
    • region_ids
      array of integers
    • custom_audience_ids
      array of strings
    • slot_type
      string [slot-type]
      Required
      Allowed values: "AUDIO", "VIDEO"Example: "AUDIO"
  • start_date
    string [date-time]
    Required
    Example: "2022-11-06T14:00:00Z"
  • end_date
    string [date-time]
    Required
    Example: "2022-11-10T14:00:00Z"

Response

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

Response sample

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