Skip to content
Ads API •References / estimates / Estimate bid

Estimate bid

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

Request

POST
/estimates/bid
  • start_date
    string [date-time]
    Required

    Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example value: "2023-09-23T04:56:07Z"
  • end_date
    string [date-time]
    Required

    Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example value: "2023-09-23T04:56:07Z"
  • asset_format
    string
    Required

    Format of the ad set.

    Example value: "AUDIO"Allowed values: "AUDIO", "VIDEO"
  • objective
    string
    Required

    Objective for a campaign (UNSET cannot be provided as an input)

    Example value: "EVEN_IMPRESSION_DELIVERY"Default value: "EVEN_IMPRESSION_DELIVERY"Allowed values: "REACH", "EVEN_IMPRESSION_DELIVERY", "CLICKS", "UNSET"
  • bid_strategy
    string
    Required

    Strategy for how bids will be applied in the auction. Allowed values:

    • "MAX_BID": The bid_micro_amount will act as a bid cap, meaning the maximum amount paid per 1000 impressions.
    Example value: "MAX_BID"Allowed values: "MAX_BID"
  • currency
    string
    Required

    Currency should be in ISO 4217 format.

    Example value: "USD"Length between 3 and 3
  • Unique items

    Specify maximum impressions per user over a given period of time. Will default to the maximum (5 per day, 35 per week, 50 per month) if not specified.

    Array maximum length: 3
  • Required

    The targets used during the creation of an ad set.

Response

Bid estimate response

  • bid_estimate_min
    integer [int64]

    The estimated smallest micro amount to bid in order to hit the desired audience.

    Example value: 14000000
  • bid_estimate_max
    integer [int64]

    The estimated largest micro amount to bid in order to hit the desired audience.

    Example value: 21000000
  • cost_model
    string

    Method used to determine how advertises are charged for their ad campaigns.

    • "CPM": Cost Per Thousand Impressions.
    • "CPCL": Cost Per Thousand Listens.
    Example value: "CPM"Allowed values: "CPM", "CPCL"
  • currency
    string

    Currency should be in ISO 4217 format.

    Example value: "USD"Length between 3 and 3

Response sample

{  "bid_estimate_min": 14000000,  "bid_estimate_max": 21000000,  "cost_model": "CPM",  "currency": "USD"}