Get your first screenshot
Capture your first screenshot and explore advanced features. You’ll go from zero to production-ready integration in under 5 minutes.1
Create your account
Sign up for a free account at screenshothis.com to get 100 free screenshots per month.
You’ll be redirected to your dashboard immediately after registration
2
Generate your API key
Navigate to API Keys in your dashboard and create your first API key.
Your API keys use domain whitelisting for security—you can safely commit them to version control. Configure allowed domains in your dashboard to control where your key works.
3
Make your first request
Test your API key with a simple screenshot request using any method below.
Your first screenshot
- cURL
- JavaScript
- Python
- PHP
The quickest way to test the API:
Your screenshot saves as
screenshot.jpeg in the current directoryCustomize your screenshots
Control format, size, and behavior with these parameters:Mobile device simulation
See how your website appears on mobile devices:API parameters
Customize your screenshots with these parameters:Required parameters
Your API key from the dashboard. Uses domain whitelisting for security—safe to commit to version control.
The website URL to screenshot. Must be a valid URL including protocol (http:// or https://).
Viewport and device settings
Viewport width in pixels. Range: 100-3840.
Viewport height in pixels. Range: 100-2160.
Simulate mobile device viewport and user agent.
Set device orientation to landscape when using mobile simulation.
Enable touch input simulation for the device.
Device pixel ratio for high-DPI displays. Common values: 1, 1.5, 2, 3.
Image output settings
Image format. Options:
jpeg, png, webp.Image quality for JPEG and WebP formats. Range: 20-100.
CSS selector to screenshot a specific element instead of the full page.
Content filtering
Block advertisements and tracking scripts for cleaner screenshots.
Automatically dismiss cookie consent banners and privacy notices.
Block all trackers and third-party scripts.
Accessibility and preferences
Set color scheme preference. Options:
light, dark.Set motion preference for animations. Options:
no-preference, reduce.Caching settings
Enable caching for this screenshot to improve performance on repeated requests.
Cache time-to-live in seconds when caching is enabled. Range: 3600-31622400 (1 hour to 1 year).
Custom cache key for grouping related screenshots. Use with
is_cached=true.Content filtering (NEW)
Block specific URL patterns during page load. One pattern per line, supports wildcards.
Block specific resource types from loading. Available types:
document, stylesheet, image, media, font, script, texttrack, xhr, fetch, prefetch, eventsource, websocket, manifest, signedexchange, ping, cspviolationreport, preflight, other.Advanced browser settings
Custom HTTP headers in
Name: Value format, one per line. Maximum size: 8KB.Custom cookies using Set-Cookie syntax, one per line. Maximum size: 4KB.
Bypass Content Security Policy restrictions. Use only when necessary for specific sites.
Security and size limits:
- Headers: Maximum 8KB total size
- Cookies: Maximum 4KB total size
- URL length: Maximum 2048 characters
- Request timeout: 30 seconds maximum
Response formats
Image response (default)
You receive the screenshot image directly as binary data:image/jpeg, image/png, or image/webp based on your format parameter.
Error responses
When requests fail, you receive a JSON error response:400- Bad request (invalid parameters)403- Forbidden (invalid API key or quota exceeded)429- Too many requests (rate limit exceeded)500- Internal server error
Test the API interactively
Try different parameters without writing code
Sample URLs for testing
Try these URLs to see different screenshot results:- Modern website:
https://screenshothis.com - Code repository:
https://github.com/screenshothis/screenshothis - Documentation:
https://docs.screenshothis.com - News site:
https://news.ycombinator.com
Real-world examples
Social media previews
Social media previews
Website thumbnails
Website thumbnails
Create thumbnails for link previews, portfolios, or dashboards:
Visual regression testing
Visual regression testing
Capture screenshots for automated testing pipelines:
Ideal for CI/CD pipelines and automated quality assurance
Direct URL rendering
Direct URL rendering
The most efficient approach - construct the URL directly:React component example:
Much more efficient! The browser fetches the image directly - no intermediate processing needed
Next steps
API Reference
Explore all available parameters, response formats, and error handling
JavaScript SDK
Use our official TypeScript SDK with full type safety and error handling
Self-hosting
Run Screenshothis on your own infrastructure for complete control
OpenAPI Spec
Generate client libraries for any programming language
og:imagetags for better social media sharing: