Default Parameters
Set default values for your screenshot requests. Every API call inherits your defaults unless explicitly overridden.
How it works
- Configure defaults in Settings → Defaults
- Every screenshot request uses your defaults as a base
- Parameters you pass in the request override the defaults
For example, if your default format is webp and you send a request with format=jpeg, the result will be JPEG.
Available defaults
| Parameter | Type | Options |
|---|---|---|
format | enum | png, jpeg, webp |
width | number | 320–3840 |
height | number | 240–2160 |
quality | number | 1–100 |
full_page | boolean | Capture full page height |
dark_mode | boolean | Emulate dark color scheme |
block_ads | boolean | Block ads and cookie banners |
delay | number | Milliseconds to wait after load |
Example
If you always screenshot at 1920×1080 in WebP format with dark mode:
Without defaults — you repeat parameters on every call:
curl "https://api.snapsharp.dev/v1/screenshot?url=https://example.com&width=1920&height=1080&format=webp&dark_mode=true" \
-H "Authorization: Bearer sk_live_..."With defaults — set them once, then just pass the URL:
curl "https://api.snapsharp.dev/v1/screenshot?url=https://example.com" \
-H "Authorization: Bearer sk_live_..."The result is the same — 1920×1080 WebP with dark mode.
Override behavior
Request parameters always take priority over defaults:
| Default | Request | Result |
|---|---|---|
format: webp | (not specified) | webp |
format: webp | format=png | png |
width: 1920 | width=1280 | 1280 |
dark_mode: true | dark_mode=false | false |
Defaults apply only to the Screenshot API (/v1/screenshot). OG Image and HTML-to-Image endpoints are not affected.