Ads API 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. However, 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.
Rate limits are set according to the the tier-level set for the developer. Presently, there are 3 tiers of access: Developer, Basic and Standard. More on these tiers can be found in our Ads API overview.
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.
For our analytics endpoints, we utilize cost-based limiting.
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
Developer-tier Rate Limits
| Endpoint Type | Scope by Endpoint or Category | Rate Limit per 1-minute window |
|---|---|---|
| Writes (POST, PUT, DELETE) | Category | 100 |
| Analytics Cost | Category | 1,000 |
| Account Reads (GET endpoints with :account_id) | Endpoint | 25 |
| Global Reads (GET endpoints without :account_id) | Endpoint | 5 |
Basic-tier Rate Limits
| Endpoint Type | Scope by Endpoint or Category | Rate Limit per 1-minute window |
|---|---|---|
| Writes (POST, PUT, DELETE) | Category | 300 |
| Analytics Cost | Category | 2,500 |
| Account Reads (GET endpoints with :account_id) | Endpoint | 50 |
| Global Reads (GET endpoints without :account_id) | Endpoint | 15 |
Standard-tier Rate Limits
| Endpoint Type | Scope by Endpoint or Category | Rate Limit per 1-minute window |
|---|---|---|
| Writes (POST, PUT, DELETE) | Category | 300 |
| Analytics Cost | Category | 5,000 |
| Account Reads (GET endpoints with :account_id) | Endpoint | 100 |
| Global Reads (GET endpoints without :account_id) | Endpoint | 25 |