Skip to content
Ads API •References / Estimate / Get Bid Estimate

Get Bid Estimate

Returns a bid estimate (recommended bid range) based on specific ad set parameters.

Request

  • ad_account_id
    string [uuid]
    Required
  • 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
  • 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"

Response

  • bid_estimate_max
    integer [int64]
    Example: 24000000
  • bid_estimate_min
    integer [int64]
    Example: 17000000
  • cost_model
    string [ad-set-cost-model]
    Allowed values: "CPCL", "CPM", "CPC", "UNSET"Example: "CPCL"

Response sample

{  "bid_estimate_max": 24000000,  "bid_estimate_min": 17000000,  "cost_model": "CPM"}