Quick Start

This guide will help you capture your first screenshot in under 5 minutes.

1. Create an Account

Sign up for a free account at app.shotone.io. You'll get free screenshots every month to start.

2. Get Your API Key

After signing in, go to your dashboard and create a new API key. Copy the key — you'll need it for authentication.

Important: Keep your API key secret. Never expose it in client-side code.

3. Make Your First Request

Use cURL to test your API key:

curl -X POST "https://api.shotone.io/screenshot" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}' \
  --output screenshot.png

If successful, you'll have a screenshot.png file in your current directory.

4. Customize Your Screenshot

Add more options to customize the output:

curl -X POST "https://api.shotone.io/screenshot" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "webp",
    "quality": 90,
    "fullPage": true,
    "device": "iphone-15-pro",
    "blockAds": true
  }' \
  --output screenshot.webp

Next Steps