Rate Limits

Quota

The BrightRoll DSP Traffic API is rate limited per the following default quota limits.

Type Limit Description
Requests Per Minute 10 Number of requests allowed in a minute per account.
Requests Per Hour 300 Number of requests allowed in an hour per account.
Requests Per Day 5000 Number of requests allowed in a day per account.

Weights

Different weights are applied to each request depending on the type. Refer to the table below for details.

Request Type Weight
GET 1
POST 3
PUT 2
DELETE 2

As an example, assuming the above default rate limits, you can send maximum 10 GET calls per minute or 5 GETs + 1 POST + 2 PUTs per minute or any combination of weights which does not exceed the defined limits.

Note

The rate limits are adjustable on an account basis but the weights are not. Please contact your Yahoo! Account Manager to get the limits changed if the defaults are not enough.

Error Messages

When any of the rate limits are exceeded, a response similar to the one below will be returned.

Example Response

{
  "response": null,
  "errors": {
    "httpStatusCode": 422,
    "message": null,
    "validationErrors": [
      {
        "message": "Rate Limit Exceeded (Per Minute)",
        "propertyName": "TRAFFIC_LIMIT_PER_MIN"
      }
    ]
  },
  "timeStamp": "2017-04-25T18:00:37Z"
}