Rate limits

Throttling headers and quota behavior

By YT2Text Team • Published February 1, 2025 • Updated February 23, 2026

Rate limits

All API requests are subject to rate limits based on the authenticated key and plan.

Response headers

Every throttled endpoint now includes:

  • X-RateLimit-Limit
    – request cap for the active window
  • X-RateLimit-Used
    – requests already consumed in that window
  • X-RateLimit-Remaining
    – requests left before throttling
  • X-RateLimit-Reset
    – Unix timestamp when the window resets
  • Retry-After
    – only returned on 429 responses

Exceeding limits

When over quota the API returns:

  • 429 Too Many Requests
  • updated limit headers
  • Retry-After
    indicating when to retry

Do not retry in a tight loop; use backoff with the returned headers.

Plan-aware limits

Current plans for the public API are:

  • free
  • starter
  • pro

Video quotas (daily + monthly)

These quotas apply to video processing (both in the app and via the API):

PlanDaily videosMonthly videos
free33
starter1050
pro30200

Security note

Rate limits are one layer only. Keep secrets server-side and never rely on throttling as your only abuse-prevention control.