Rate Limits

This article describes DSP Traffic API rate limits by minute, hour, and day, and request-type weighting and services that enable you to read the current rate limits for your account.

Overview

DSP Traffic API rate limits are adjustable on an account-by-account basis. As a baseline, all accounts are allotted a fixed number of requests per minute, per hour, and per day.

The DSP Traffic API assigns different weights to requests based on the request type.

Rate Limits

The 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 user account.
Requests Per Hour 300 Number of requests allowed in an hour per user account.
Requests Per Day 5000 Number of requests allowed in a day per user account.

Weights

DSP Traffic API applies different weights to request depending on the method.

While rate limits are adjustable, the weights assigned to requests are not. If the default rate limits are insufficient, contact your account manager to get the limits changed.

Request Type Weight
GET 1
POST 3
PUT 2
DELETE 2

For example, you can send maximum ten GET calls per minute or five GET calls, one POST call, and one PUT call per minute or any combination of weights that does not exceed the defined limits.

Read Current Rate Limits

Retrieves the current rate limits for your user account.

GET /traffic/ratelimit

The request takes no parameters.

Example Request

GET https://dspapi.admanagerplus.yahoo.com/traffic/ratelimit

Example Response

The response contains the rate limits in minute, hour, and day for your user account.

{
  "response":
    {
       "limitPerMin": 1000,
       "limitPerHour": 2000,
       "limitPerDay": 5000
    }
  "errors": null,
  "timeStamp": "2017-10-03T20:07:17Z"
}

Error Messages

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

{
  "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"
}