General
Rate Limiting
The Advertiser API is rate limited similarly to REST API v1.1, as documented here: REST API Rate Limiting in v1.1. Limits are generous for most endpoints and should not impede use cases. Unlike REST API v1.1, there is no programmatic index of the limits per endpoint. However, the limits will still be communicated in the HTTP response headers (x-rate-limit-limit, x-rate-limit-remaining and x-rate-limit-reset).
Some methods allow you to specify a comma-separated list of values, usually to retrieve multiple pieces of similar data. Such methods allow up to 50 criteria to be specified per request, unless noted otherwise.
Scopes of Rate Limiting
All rate limiting in the Advertiser API utilizes OAuth 1.0A and user-context. Each user token has its own distinct rate limits, even when accessing multiple advertiser accounts.
See the Analytics Rate Limiting Guide for more information about analytics endpoint rate limits.
Scopes for this doc
- Category: all endpoints that fall into the given category are rate limited from a single allocated limit per window.
- Endpoint: each endpoint has its own distinct allocated limit per window.
Rate Limits
Ads API Rate Limits
| Endpoint Type | Scope by Endpoint or Category | Rate Limit per 1-minute window |
|---|---|---|
| Writes (POST, PUT, DELETE) | Category | 300 |
| Endpoint Type | Scope by Endpoint or Category | Rate Limit per 15-minute window |
|---|---|---|
| Analytics (synchronous) | Category | 250 |
| Account Reads (GET endpoints with :account_id) | Endpoint | 2000 |
| Targeting Criteria (besides below) | Category | 400 |
| Targeting Criteria (tv_markets, tv_shows) | Endpoint | 2000 |
| Audience Insights | Category | 400 |
| Keyword Insights | Category | 500 |
| Global Reads (GET endpoints without :account_id) | Endpoint | 5 |