Responses and headers
What comes back from each endpoint, the headers on every response, and how to check your usage.
Response bodies#
| Endpoint | Default body | With response_type: "url" |
With response_type: "base64" |
|---|---|---|---|
| Screenshot | The image | JSON with a link | JSON with the image |
| The PDF | JSON with a link | JSON with the PDF | |
| Extract | JSON | — | — |
Links from response_type: "url" work for 24 hours. Then the file is deleted.
Headers#
| Header | Description |
|---|---|
X-Quota-Limit |
Your monthly quota |
X-Quota-Used |
Renders used this month, including this one |
X-Quota-Remaining |
Renders left this month |
X-Render-Time |
Milliseconds the browser spent on the page |
X-Target-Status |
The HTTP status the target site answered with. A 404 page is still rendered. |
X-Cache |
HIT when the result came from the cache, otherwise MISS |
Retry-After |
Seconds to wait, on 429 responses |
The X- headers can be read from browser JavaScript too.
Check your usage#
curl https://rendersbolt.com/v1/usage -H "Authorization: Bearer $API_KEY"{ "plan": "starter", "period": "2026-10", "used": 1204, "limit": 25000, "remaining": 23796 }/v1/usage doesn't count as a render. Quotas reset at 00:00 UTC on the first day of each month.
Stuck? Write to [email protected] with the request you sent and the error code you got back.