Getting Started

Rate Limits

Two limits apply to every account: a per-minute request rate and a monthly credit allowance. Exceed the request rate and the API returns a 429; run out of credits and it returns a 402.

Limits by Plan

Plan	Credits	Rate Limit	Burst
Free	100/mo	10 req/min	—
Basic	300/mo	30 req/min	—
Pro	3,000/mo	100 req/min	200
Mega	30,000/mo	300 req/min	600
Giga	300,000/mo	600 req/min	1,200
Supa	1,000,000/mo	600 req/min	1,200
Enterprise	Unlimited	Unlimited	Custom

Response Headers

Every successful response carries the headers below, so you can track your remaining requests and credits without making a separate call.

X-RateLimit-LimitMaximum requests allowed per minute for your plan

X-RateLimit-RemainingRequests remaining in the current window

X-RateLimit-ResetUnix timestamp when the rate limit window resets

X-Credits-UsedCredits consumed by this request

X-Credits-RemainingCredits remaining in your monthly allowance

Rate Limit Error (429)

429 Too Many Requests

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please slow down.",
    "requestId": "req_abc123"
  }
}

Best practices

→

Read X-RateLimit-Remaining before each burst of requests

→

Implement exponential backoff when you receive a 429 response

→

Use batch endpoints (POST /v1/youtube/transcript/batch) to reduce request count

→

Cache transcript results — they rarely change for published videos

→

Contact support@supacrawlx.com to discuss Enterprise limits