Rate limits

A rate limit is the number of API calls an AdAccount or user can make within a given time period. If this limit is exceeded, any users under specific AdAccount or particular user may be throttled. API requests made by a throttled user will fail.

All API requests are subject to rate limits. APIs accessing resources under AdAccount scope are limited on AdAccount basis, while the rest APIs are limited on user basis. For more details, please refer to the Quota section below.

Quota

By default, all the APIs are limited on AdAccount basis with quota of 300 / 5min.

Endpoint

Basis

Quota

Default

AdAccount

300 / 5min

GET/campaign-summary

AdAccount

  • 60 / min: If group_by parameter only contains DATE, AD_ACCOUNT, APP_OR_SITE, CAMPAIGN, AD_GROUP
  • 60 / hour
  • Limit: the result taking more than 5 mins is canceled.

POST /campaign-summary/query

AdAccount

  • 60 / min: If group_by parameter only contains DATE, AD_ACCOUNT, APP_OR_SITE, CAMPAIGN, AD_GROUP
  • 60 / hour
  • Limit: the result taking more than 5 mins is canceled.

GET/report-action-events

AdAccount

60 / min

GET/cohort-summary

AdAccount

  • 60 / min: If type is ROAS type(ROAS, UA_ROAS, RE_ROAS)
  • 60 / hour: If type is KPI_ACTION type(KPI_ACTION, UA_KPI_ACTION, RE_KPI_ACTION)

POST /reports

AdAccount

  • 0~1 date range: 30 / day
  • 2~7 date range: 10 / day
  • 8~31 date range: 5 / day
  • Limit: the result of more than 2M rows is rejected.

POST /logs

AdAccount

30 / day

GET /ad-accounts

User

300 / 5min

GET /configuration

User

300 / 5min

HTTP response codes

When an application exceeds the rate limit for a given API endpoint, the API will return a HTTP 429 “Too Many Requests” response code, and the following error will be returned in the response body:

{
    "code": 8,
    "message": "API quota exceeded. Please try again later. code = ResourceExhausted"
}