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.

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 rate is rate-limited per the following default quota limits based on the number of calls in a rolling window of time.

Type	Limit	Description
Requests Per Minute	50	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 a maximum of 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.

Sample Request¶

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

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