Website Screenshot API

Capture pixel-perfect screenshots of any website using the AllScreenshots API. This Actor supports single URLs, bulk processing (up to 100 URLs), 30+ device presets, full-page capture, dark mode, ad blocking, and more.

Features

• 30+ Device Presets: iPhone (SE to 15 Pro Max), iPad, Android (Pixel, Galaxy), Desktop, and Social Media sizes
• Bulk Processing: Capture up to 100 URLs in a single run
• Full Page Screenshots: Capture entire scrollable pages
• Dark Mode: Force dark theme on supported websites
• Ad & Cookie Banner Blocking: Clean screenshots without distractions
• Multiple Formats: PNG, JPEG, WebP, or PDF output
• Custom CSS Injection: Hide elements or modify styles
• Element Selection: Capture specific page elements

Quick Start

Minimum Configuration

{
    "apiKey": "your-allscreenshots-api-key",
    "urls": ["https://example.com"]
}

Get Your API Key

1. Visit AllScreenshots.com
2. Sign up for a free account
3. Copy your API key from the dashboard

Input Parameters

Essential

Parameter	Type	Required	Description
apiKey	String	Yes	Your AllScreenshots API key
urls	Array	Yes*	List of URLs to screenshot
url	String	Yes*	Single URL to screenshot

*Either urls or url is required.

Device & Viewport

Parameter	Type	Default	Description
devicePreset	String	-	Device preset (e.g., iphone-15-pro-max, desktop-hd)
viewportWidth	Integer	1920	Custom viewport width (100-4096)
viewportHeight	Integer	1080	Custom viewport height (100-4096)
deviceScaleFactor	Integer	1	Pixel density (1-3)

Available Device Presets

Desktop

• desktop-hd (1920x1080)
• desktop-large (1440x900)
• desktop-retina (2560x1440 @2x)
• laptop (1366x768)
• laptop-retina (1536x864 @2x)

iPhone

• iphone-se, iphone-xr, iphone-12, iphone-12-pro-max
• iphone-14, iphone-14-pro-max, iphone-15, iphone-15-pro-max

iPad

• ipad, ipad-pro-11, ipad-pro-12-9, ipad-mini

Android

• pixel-5, pixel-7, pixel-7-pro
• galaxy-s21, galaxy-s23, galaxy-tab-s7
• surface-pro-7

Social Media

• facebook-og (1200x630)
• twitter-card (1200x675)
• linkedin-post (1200x627)
• instagram-square (1080x1080)
• instagram-portrait (1080x1350)
• instagram-story (1080x1920)

Output Format

Parameter	Type	Default	Description
format	String	png	Output format: png, jpeg, webp, pdf
quality	Integer	90	Image quality 1-100 (JPEG/WebP only)
fullPage	Boolean	false	Capture entire scrollable page

Page Loading

Parameter	Type	Default	Description
delay	Integer	0	Delay before capture (ms, 0-30000)
waitFor	String	-	CSS selector to wait for
waitUntil	String	load	Wait event: load, domcontentloaded, networkidle
timeout	Integer	30000	Page load timeout (ms, 1000-60000)

Page Customization

Parameter	Type	Default	Description
darkMode	Boolean	false	Force dark mode
customCss	String	-	Custom CSS to inject
hideSelectors	Array	-	CSS selectors of elements to hide
selector	String	-	Capture specific element only

Content Blocking

Parameter	Type	Default	Description
blockAds	Boolean	true	Block advertisements
blockCookieBanners	Boolean	true	Block cookie consent banners
blockLevel	String	normal	Blocking intensity: none, light, normal, pro, pro_plus, ultimate

Output Options

Parameter	Type	Default	Description
outputToDataset	Boolean	true	Save metadata to Dataset
outputToKeyValueStore	Boolean	true	Save images to Key-Value Store
fileNamePattern	String	{domain}_{timestamp}.{format}	File naming pattern

Output

Dataset

Each screenshot produces a dataset record:

{
    "url": "https://example.com",
    "screenshotKey": "example_com_1705123456789.png",
    "screenshotUrl": "https://api.apify.com/v2/key-value-stores/xxx/records/example_com_1705123456789.png",
    "capturedAt": "2025-01-15T12:30:45.789Z",
    "format": "png",
    "viewport": "1920x1080",
    "devicePreset": null,
    "fullPage": false,
    "fileSize": 245678,
    "success": true,
    "error": null,
    "processingTimeMs": 1523
}

Key-Value Store

Screenshot images are stored with the key pattern you specify (default: {domain}_{timestamp}.{format}).

Examples

Mobile Screenshot

{
    "apiKey": "your-api-key",
    "urls": ["https://example.com"],
    "devicePreset": "iphone-15-pro-max",
    "format": "webp",
    "quality": 85
}

Full Page with Ad Blocking

{
    "apiKey": "your-api-key",
    "urls": ["https://news-site.com/article"],
    "fullPage": true,
    "blockAds": true,
    "blockCookieBanners": true,
    "blockLevel": "pro"
}

Dark Mode Screenshots

{
    "apiKey": "your-api-key",
    "urls": ["https://github.com", "https://twitter.com"],
    "darkMode": true,
    "devicePreset": "desktop-hd"
}

Social Media Images

{
    "apiKey": "your-api-key",
    "url": "https://your-website.com/landing-page",
    "devicePreset": "facebook-og",
    "format": "jpeg",
    "quality": 90
}

Hide Elements

{
    "apiKey": "your-api-key",
    "urls": ["https://example.com"],
    "hideSelectors": [".cookie-banner", "#popup", ".advertisement"],
    "customCss": "body { background: white !important; }"
}

Bulk Processing

{
    "apiKey": "your-api-key",
    "urls": [
        "https://example.com",
        "https://google.com",
        "https://github.com",
        "https://twitter.com"
    ],
    "devicePreset": "desktop-hd",
    "format": "png"
}

Pricing

This Actor uses the AllScreenshots API. You need an API key to use it.

• Free tier: 100 screenshots/month
• Paid plans: Higher limits available

Visit AllScreenshots.com for pricing details.

Support

• Actor Issues: GitHub Issues
• API Documentation: AllScreenshots Docs
• API Support: support@allscreenshots.com

License

ISC