Base URL
https://api.domainshots.aiAuthentication
All API requests require authentication using an API key. Include your API key in the Authorization header as a Bearer token.
Header Format
Authorization: Bearer YOUR_API_KEYQuick Start
Get started with your first API call in minutes.
Capture Your First Screenshot
curl -X POST https://api.domainshots.ai/screenshot \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"device": "desktop",
"analyze": true
}'API Endpoints
POST
/screenshotCapture a website screenshot with optional AI analysis
Auth: Required
GET
/screenshot/{id}Get screenshot details and analysis results
Auth: Required
GET
/screenshot/history/{domain}Get screenshot history for a domain
Auth: Required
GET
/screenshot/diff/{id1}/{id2}Compare two screenshots and get AI diff analysis
Auth: Required
Capture Screenshot
POST
/screenshotRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Required | URL to capture |
device | string | Optional | desktop, laptop, tablet, or mobile |
full_page | boolean | Optional | Capture full scrollable page |
analyze | boolean | Optional | Include AI analysis (default: true) |
Response
{
"success": true,
"screenshot": {
"id": "ss_abc123",
"url": "https://example.com",
"screenshot_url": "https://cdn.domainshots.ai/ss_abc123.png",
"thumbnail_url": "https://cdn.domainshots.ai/ss_abc123_thumb.png",
"captured_at": "2026-01-17T14:30:00Z",
"width": 1920,
"height": 1080,
"response_time_ms": 342,
"http_status": 200
},
"analysis": {
"ai_analysis": {
"description": "A modern corporate website...",
"content_type": "Corporate/Business",
"language": "English"
},
"tech_stack": {
"frameworks": ["React", "Next.js"],
"hosting": "Vercel",
"analytics": ["Google Analytics"]
},
"security_score": 87
}
}Rate Limits
Rate limits are based on your plan and applied per API key.
| Plan | Requests/minute | Monthly Quota |
|---|---|---|
| Free | 5 | 5 screenshots |
| Starter | 30 | 100 screenshots |
| Professional | 60 | 500 screenshots |
| Enterprise | 120 | 2500 screenshots |