Appearance
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.
| Header | Example | Meaning |
|---|---|---|
X-RateLimit-Limit | 60 | Per-minute ceiling for your plan |
X-RateLimit-Remaining | 47 | Calls left in the current minute window |
X-RateLimit-Reset | 1715209260 | Unix epoch seconds when the window resets |
X-Monthly-Usage-Limit | 50000 | Monthly quota for your plan |
X-Monthly-Usage-Remaining | 38291 | Requests left this billing month |
429 responses also include:
| Header | Example | Meaning |
|---|---|---|
Retry-After | 12 | Seconds to wait before the next attempt |
Job Tracking
| Header | Example | Meaning |
|---|---|---|
X-Job-ID | job_a1b2c3d4e5f6 | Identifier for cancellation via DELETE /v1/jobs/{id} |
Bypass
| Header | Example | Meaning |
|---|---|---|
X-Runo-Paid-Tier-Throttled | true | A 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.