API Reference
ScreenCapr provides a high-performance REST API for capturing website screenshots. Unlike other services, we stream results directly to you with zero storage overhead.
Base URL
https://api.screencapr.comSingle Screenshot
POSTCapture a single URL and receive the raw binary image data instantly.
Body Parameters
RequiredThe URL of the website to capture (must include http/https).
Default:
Viewport width.
Default: 1920
Viewport height.
Default: 1080
Capture entire scrollable content.
Default: false
Image format.
Default: png
JPEG quality (if format is jpeg).
Default: 80
Capture timeout in ms.
Default: 30000
Success Response
200 OK
Returns raw binary data with image/png or image/jpeg header.
Batch Screenshots
POSTCapture up to 10 URLs simultaneously and receive a single ZIP file containing all results.
Array of strings. Max 10 URLs.
Same shared options as single screenshot.
200 OK
Returns binary ZIP data with application/zip header.
Health Check
GETMonitor server health, uptime, and resource usage.
{
"status": "ok",
"timestamp": "2024-01-19T14:48:00Z",
"uptime": 3600,
"memory": {
"used": 142,
"total": 512,
"percentage": 27
},
"activeBrowsers": 2
}Error Handling
When something goes wrong, the API returns a standard JSON error structure.
Bad Request
Validation failed for provided parameters.
Timeout
Screenshot took longer than defined limit.
Rate Limit
Maximum requests per window exceeded.
Server Error
Unexpected error during capture process.