Introduction to DevThumbs API
Welcome to the DevThumbs API documentation. DevThumbs is a high-performance screenshot API built on Cloudflare's global edge network. Capture website screenshots at scale with intelligent caching, automatic scrolling, and advanced features like element capture, custom JavaScript injection, and PDF generation.
Quick Start
Get started with a simple screenshot capture in seconds:
curl"https://api.devthumbs.com/v1/screenshot?url=https://www.apple.com"\
-H"x-api-key: YOUR_API_KEY"
Tip: Check the Authentication section to get your API key, then explore the Screenshots API for advanced options.
API Endpoints Overview
| Endpoint | Method | Description |
|---|---|---|
| /v1/screenshot | GET, POST | Capture a screenshot |
| /v1/screenshot/status/:hash | GET | Check capture status |
| /v1/batch | POST | Submit batch job (PRO+) |
| /v1/batch/:id/status | GET | Check batch status |
| /v1/schedules | GET, POST | Manage scheduled captures (PRO+) |
| /v1/account/me | GET | Get account details |
API Architecture
The DevThumbs API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes and verbs.
Base URL
https://api.devthumbs.comAll endpoints are versioned under /v1
Asynchronous Processing
Screenshot captures are asynchronous. The typical flow is:
Submit Request
POST to /v1/screenshot with your URL and options.
Receive Job Hash
You get a PENDING status with a unique hash immediately.
Wait for Completion
Poll the status endpoint or receive a webhook notification.
Retrieve Screenshot
Use the s3Url to download your image. Images are retained for 3 days.
Request ID Tracing
Every API response includes an x-request-id header. Include this ID when contacting support for debugging.
x-request-id: 550e8400-e29b-41d4-a716-446655440000Documentation Sections
Authentication
API keys and security
Screenshots
Core capture API
Batch Operations
Multiple URLs at once
Schedules API
Recurring captures
WebSocket API
Real-time progress
Webhooks
Async notifications
Account & Keys
Account management
Pricing & Credits
Cost estimation
Errors & Rate Limits
Troubleshooting