Skip to content

Response headers

Headers carry metadata you'll often want without parsing the body.

Rate Limit & Quota

Every response includes both per-minute and monthly counters.

HeaderExampleMeaning
X-RateLimit-Limit60Per-minute ceiling for your plan
X-RateLimit-Remaining47Calls left in the current minute window
X-RateLimit-Reset1715209260Unix epoch seconds when the window resets
X-Monthly-Usage-Limit50000Monthly quota for your plan
X-Monthly-Usage-Remaining38291Requests left this billing month

429 responses also include:

HeaderExampleMeaning
Retry-After12Seconds to wait before the next attempt

Job Tracking

HeaderExampleMeaning
X-Job-IDjob_a1b2c3d4e5f6Identifier for cancellation via DELETE /v1/jobs/{id}

Bypass

HeaderExampleMeaning
X-Runo-Paid-Tier-ThrottledtrueA daily kill-switch for T4 (CAPTCHA solver) or T5 (residential proxies) is active; the call fell back to T6 archive lookup

Standard Headers

Content-Type: application/json on all successful responses. CORS is enabled for browser usage where appropriate.

Released under the terms of Runo’s Terms of Use.