v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
ad_groups

Get bid floors

List bid floors for your campaign configuration. Bid floors are given in microcurrency values based on the currency in the bid floor specification.

Microcurrency is used to track very small transactions, based on the currency set in the advertiser's profile.

A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser's profile.

Equivalency equations, using dollars as an example currency:

  • $1 = 1,000,000 microdollars
  • 1 microdollar = $0.000001

To convert between currency and microcurrency, using dollars as an example currency:

  • To convert dollars to microdollars, mutiply dollars by 1,000,000
  • To convert microdollars to dollars, divide microdollars by 1,000,000

For more on bid floors see Set your bid.

post/ad_accounts/{ad_account_id}/bid_floor

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

Example request

{
  "bid_floor_specs": [
    {
      "billable_event": "CLICKTHROUGH",
      "objective_type": "AWARENESS"
    }
  ],
  "targeting_spec": {
    "SHOPPING_RETARGETING": [
      {
        "lookback_window": 30,
        "exclusion_window": 14,
        "tag_types": [
          0,
          6
        ]
      }
    ]
  }
}

Response

The request has succeeded.

bid_floorsinteger[]

A list of bid floors in micro currency. For example, [100000, 200000]

typestring

Always the string 'bidfloor'.

Example response

{
  "bid_floors": [
    100000,
    200000
  ],
  "type": "bidfloor"
}