ScreenshotCoreScreenshotCore

Rate Limits

Two independent limits apply: a per-minute request cap and a monthly screenshot quota. Both vary by plan.

Per-minute rate limit

Every request counts against a sliding 60-second window keyed to your account. The limit depends on your plan:

  • Free: 10 requests per minute
  • Starter: 40 requests per minute
  • Growth: 80 requests per minute
  • Scale: 150 requests per minute

Every response includes X-RateLimit-Limit (your cap) and X-RateLimit-Remaining (requests left this minute). When the limit is exceeded the API returns 429 with a Retry-After header telling you how many seconds to wait.

Monthly quota

Screenshots and videos each have a separate monthly allowance (see the Plans page). The Free plan hard-caps at the quota. Paid plans continue capturing and bill overage at the per-capture rate for your plan.

Best practices

  • Read X-RateLimit-Remaining on each response and slow down when it approaches zero.
  • Use exponential back-off when you receive a 429: start with the Retry-After value and double on each retry.
  • Use cache_ttl to avoid re-capturing the same URL within a short window.
  • For large bursts (50+ captures), use async mode so jobs queue rather than block.

Response

HTTP/2 200 OK
Content-Type: image/png
X-RateLimit-Limit: 80
X-RateLimit-Remaining: 53
X-Response-Time: 245
X-Cache: MISS
X-Request-Id: 201
ErrorsPlans