Render a screenshot from a signed URL
A signed, embeddable variant of `POST /screenshots` that returns the raw image bytes directly — so a signed URL can be dropped straight into an `<img src>` with **no API key**. PDF output is not supported here; use `POST /screenshots` for PDFs. Authentication is by **signature**, not a Bearer token. The `signature` query parameter is an HMAC-SHA256 of the canonical query string (every parameter except `signature`, sorted by key and joined with `&`), keyed by your organization's signing secret. See [Signed URLs](/docs/guides/screenshots#signed-urls) for how to generate one. Every rendering option from `POST /screenshots` (for example `format`, `fullPage`, `device`, `darkMode`, `cache`) may be passed as a query parameter. Responses set `X-docr-Cache: hit` or `miss` and a one-hour `Cache-Control`.
Query Parameters
Your organization id (the signing tenant).
HMAC-SHA256 of the canonical query string (hex).
URL to render. Provide exactly one of url or html.
uriRaw HTML to render. Provide exactly one of url or html.
Image format. pdf is not available on this endpoint.
"png""png" | "jpeg" | "webp"Capture the full scrollable height of the page.
falseReuse a stored render for identical options (0 credits on a hit).
falseResponse Body
application/json
application/json
application/json
curl -X GET "https://app.docr.dev/api/v1/take?t=string&signature=string""string"{
"error": "Invalid signature"
}{
"error": "Credit limit reached (100/100). Upgrade your plan."
}{
"error": "string"
}