Bidding Rules

GET bidding_rules

Retrieve the bidding rules for some or all currencies. The response will indicate the minimum and maximum CPE (cost-per-engagement) bids.

While these bidding rules change rarely, it is suggested that your systems refresh from these endpoints at least monthly.

Resource URL

https://ads-api.twitter.com/4/bidding_rules

Parameters

Name Description
currency
optional

The type of a currency to filter results by, identified using ISO-4217. This is a three-letter string "USD" or "EUR". Omit this parameter to retrieve all bidding rules. associated with the authenticating user.

Type: string

Example: USD

Example Request

GET https://ads-api.twitter.com/4/bidding_rules?currency=USD

Example Response

{
  "request": {
    "params": {
      "currency": "USD"
    }
  },
  "data_type": "bidding_rule",
  "data": [
    {
      "currency": "USD",
      "minimum_cpe_bid_local_micro": 10000,
      "maximum_cpe_bid_local_micro": 1000000000,
      "minimum_denomination": 10000
    }
  ],
  "total_count": 1
}