File size: 1,010 Bytes
6a7089a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | # Screenshot
Capture the current page as an image. Defaults to **JPEG** format.
```bash
# Get raw PNG bytes
curl "http://localhost:9867/screenshot?format=png&raw=true" > page.png
# Get JSON with base64 JPEG (default)
curl "http://localhost:9867/screenshot"
# Save to server state directory
curl "http://localhost:9867/screenshot?output=file"
```
## Response (JSON)
```json
{
"path": "/path/to/state/screenshots/screenshot-20260308-120001.jpg",
"size": 34567,
"format": "jpeg",
"timestamp": "20260308-120001"
}
```
## Useful flags
### API Query Parameters
- `format`: `jpeg` (default) or `png`.
- `quality`: JPEG quality `0-100` (default: `80`). Ignored for PNG.
- `raw`: `true` to return image bytes directly instead of JSON.
- `output`: `file` to save to state directory.
- `tabId`: Target a specific tab.
### CLI
- `-o <path>`: Save to specific path.
- `-q <0-100>`: Set JPEG quality.
- `--tab <id>`: Target a specific tab.
## Related Pages
- [Snapshot](./snapshot.md)
- [PDF](./pdf.md)
|