The vocabulary of the Website Screenshot API

The 7 fields and concepts you'll meet in the response — defined in plain English, each with a real example value.

7 terms
Technology2

Headless Browser

A web browser without a graphical interface, running in the background for automation and rendering.

Headless browsers like Chrome Headless or Puppeteer execute JavaScript, apply CSS, and render pages exactly like visual browsers. They're essential for screenshot APIs, testing automation, and web scraping. Running "headless" means no windows or UI are displayed.

ExampleChrome with --headless flag, Puppeteer, Playwright

Device Emulation

Simulating a specific device by setting viewport size, pixel density, and user agent.

Device emulation makes websites render as they would on specific devices. This includes setting viewport dimensions, device pixel ratio (for Retina displays), touch capabilities, and user agent strings. Useful for capturing mobile views without physical devices.

ExampleiPhone 14 Pro: 393x852 viewport, 3x pixel ratio, iOS Safari user agent

Dimensions1

Viewport

The visible area of a webpage in the browser window, defined by width and height in pixels.

Viewport dimensions determine how much of a webpage is visible without scrolling. Screenshot APIs accept viewport parameters to emulate different screen sizes. Common viewports include mobile (375x667), tablet (768x1024), and desktop (1920x1080). The viewport affects responsive layout behavior.

Examplewidth: 1920, height: 1080 for full HD desktop

Capture Modes1

Full-Page Capture

A screenshot that captures the entire scrollable page, not just the visible viewport.

Full-page screenshots scroll through the entire document and stitch the results into one image. This captures content below the fold that requires scrolling to see. Full-page captures can be very tall for long pages. Use viewport-only captures for consistent thumbnail dimensions.

ExampleA blog post screenshot showing all paragraphs from title to footer

Formats1

PNG Format

Portable Network Graphics—a lossless image format ideal for screenshots.

PNG preserves image quality without compression artifacts, making it ideal for screenshots with text and UI elements. It supports transparency and provides crisp, accurate captures. PNG files are larger than JPEG but quality is perfect.

Examplescreenshot.png with exact pixel reproduction

Use Cases2

Link Preview

A visual thumbnail shown when URLs are shared in chat or social media.

Link previews give users a visual glimpse of destination content before clicking. Screenshot APIs generate these thumbnails on-demand. Platforms like Slack, Discord, and Twitter use previews. Standard dimensions follow Open Graph specifications (1200x630) or smaller thumbnails.

ExampleSlack unfurling a URL to show website screenshot

Visual Monitoring

Periodically capturing screenshots to detect visual changes or issues.

Visual monitoring captures screenshots at intervals (hourly, daily) and compares them to baselines. Changes can be detected via image hashing or pixel-diff algorithms. This catches broken layouts, missing images, content changes, and defacement faster than manual checking.

ExampleDaily screenshots compared to detect homepage changes

See these fields live. Run the Website Screenshot API free — no card, no signup wall.

Scaling up?

Volume pricing, custom SLAs, and dedicated support for high-traffic teams.

Contact sales