Rate Limits

300 requests per minute, per API key.

The basics

  • Default rate limit: 300 requests per minute per API key.
  • The window is rolling — counts decay continuously, not at fixed-second boundaries.
  • Each key has an independent budget. Adding more keys does not raise your account-level limit.

Headers

Every response carries the current rate limit state:

http
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1735689600
Retry-After: 7   # only on 429

Recommended client behavior

  1. On 200: read X-RateLimit-Remaining; throttle if it dips below 10% of your limit.
  2. On 429: sleep for Retry-After seconds and retry once.
  3. On 503 / 408: exponential backoff (1s, 2s, 5s) and stop after 3 attempts.

Need more headroom?

Enterprise plans get dedicated rate limits — get in touch via the contact form.

Rate Limits — YouTubeTranscriptAPI