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/8/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/8/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
}

Was this document helpful?

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.