Capture screenshots with curl
Add screenshot and scrolling GIF capabilities to your shell scripts and CI/CD pipelines with curl. No installation required, works everywhere.
Installation
- 1curl is pre-installed on most systems (Linux, macOS, Windows 10+)
- 2Get your API key from the dashboard
- 3Pass the X-KEY header using the -H flag
Authentication
Include your API key in the X-KEY header with every request:
curl "https://api.scrnpix.com/screenshot?url=..." \ -H "X-KEY: your-api-key" \ -o screenshot.png
curl Screenshot Example
Capture a screenshot or create a scrolling GIF animation with a simple GET request:
curl "https://api.scrnpix.com/screenshot?url=https%3A%2F%2Fexample.com&width=1280&height=720&format=png" \ -H "X-KEY: your-api-key" \ -o screenshot.png
curl "https://api.scrnpix.com/animate?url=https%3A%2F%2Fexample.com&scroll_duration=3000&scroll_easing=ease-in-out" \ -H "X-KEY: your-api-key" \ -o animation.gif
Response Format
On success, the API returns the image binary data directly in the response body.
| Status Code | 200 OK |
| Content-Type | image/png, image/jpeg, or image/gif |
| Body | Binary image data (stdout or -o file) |
| Error Response | Error message with 4xx/5xx status |
Key Features
Zero Setup
curl is pre-installed on most systems. No additional dependencies or browser installations required.
Production Ready
Built on Cloudflare Workers with global edge network. Perfect for CI/CD pipelines, monitoring, and automation.
Universal Compatibility
Works on Linux, macOS, Windows, and any system with curl. Ideal for shell scripts, GitHub Actions, Jenkins, and more.
Rich Features
Custom viewport sizes, full page capture, PNG/JPEG formats, scrolling GIFs with 15 easing functions.
Frequently Asked Questions
Do I need to install anything to use curl?
No. curl is pre-installed on most Linux and macOS systems. Windows 10+ includes curl by default.
Can I use this in CI/CD pipelines?
Yes. Perfect for GitHub Actions, GitLab CI, Jenkins, CircleCI, or any CI/CD system that supports shell commands.
How do I handle errors with curl?
Use the -w flag to check HTTP status codes. A 200 status means success. Use -f flag to fail silently on HTTP errors.
Can I pipe the output to other commands?
Yes. curl outputs binary image data to stdout, which you can pipe to other commands or redirect to files for further processing.
Ready to capture screenshots with curl?
Get your API key and start rendering screenshots in seconds. Free tier includes 50 screenshots per month.
Start Free