¶ How rate limiting works

To ensure optimal performance for all users, the Ads API implements rate limiting on a per-user, per-ad-account, and per-integrator basis. This means your request limits may be tied to the user you’re calling on behalf of, to the specific ad account you’re accessing, or to your integrator application.

¶ Understanding your limits

Rate limits vary by endpoint and are designed to support typical usage patterns while preventing abuse.

¶ When you hit a limit

If you exceed your rate limit, you’ll receive a 429 Too Many Requests response. The response will include information about when you can make requests again.

¶ Current limits

Rate limits are subject to change. Three kinds of limits apply: per-user limits, per-ad-account limits, and per-integrator limits (limits that apply across all users for your integration). Most endpoints are limited per ad account. Get Ad Accounts is the exception: because it is the endpoint you call to discover which ad accounts a user can access, it is limited per user. The current limits are: