API Documentation

DomainShots.ai API

Capture website screenshots and analyze them with AI, powered by our state-of-the-art siteshotsd engine. GPU-accelerated inference delivers lightning-fast screenshots with tech stack detection and security scoring.

RTX 4090 GPU workers with automatic fal.ai fallback for 99.9% uptime

Base URL

https://api.domainshots.ai

siteshotsd Engine

DomainShots.ai is powered by siteshotsd, our proprietary screenshot capture and AI analysis daemon. It delivers enterprise-grade performance at 90%+ lower cost compared to traditional cloud APIs.

GPU Workers

RTX 4090 powered inference via vast.ai

Auto Scaling

Workers scale based on demand

Smart Fallback

fal.ai backup ensures 99.9% uptime

Engine Selection

Use the engine parameter to control routing:

autoDefault. Uses siteshotsd with automatic fallback.

siteshotsdForce siteshotsd. Fails if unavailable.

localBypass siteshotsd and use direct fal.ai.

Authentication

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_KEY

Quick 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/screenshot

Capture 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/screenshot

Request 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)
`engine`	string	Optional	auto, siteshotsd, or local (default: auto)

Response

{
  "success": true,
  "engine": "siteshotsd→vastai",
  "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

Need Help?

Our team is here to help you integrate DomainShots.ai into your application.