Web API·2 credits per call

Capture high-fidelity website screenshots instantly.

Send a URL and receive a visual render. No headless browser clusters to manage or complex viewport logic to write.

POSTautomatio.ai/api/v1/query{ tool: "web_screenshot", params: { url: … } }

Live demo

Try it live.

Change the parameters and run a real request against the endpoint. No account, no key.

URLrequired
Device

Free to try, no account. Costs 2 credits on your own key.

POST /api/v1/query · web_screenshot

Run the request to see a live response.

Request
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"web_screenshot","params":{"url":"https://stripe.com","device":"desktop"}}'

How it works

One request, one response.

  1. 1

    Define the target

    Specify the target URL along with optional viewport dimensions or device emulation settings.

  2. 2

    Render the page

    The service processes CSS, JavaScript, and media assets to generate a pixel-perfect representation.

  3. 3

    Receive the image

    The API returns a JSON response containing the rendered image data for your application to consume.

Capabilities

What you get.

Everything this endpoint does, without running the infrastructure yourself.

Full page rendering

Capture the entire scrollable height of a page by setting the fullPage boolean to true.

Device emulation

Switch between desktop, tablet, and mobile profiles using the device parameter to test responsive layouts.

Element manipulation

Use hideSelectors to remove intrusive elements like cookie banners or popups from the final render.

State control

Trigger darkMode or set custom locale strings to see how content adapts to different user environments.

Cost of ownership

Build it yourself, or call this.

Both are real options. Here is what each one actually costs you.

Run it yourself

  • Manage Playwright or Puppeteer clusters
  • Handle complex font rendering and GPU acceleration
  • Debug memory leaks and zombie browser processes
  • Scale infrastructure for high-concurrency captures

Call the API

  • Single POST request integration
  • Automatic resource management and cleanup
  • Built-in support for JS-heavy single page applications
  • Predictable credit-based billing per call

Integrate

Built for the language you use.

One HTTP endpoint. Copy the call in your language and go.

example.sh
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tool": "web_screenshot", "params": { "url": "https://example.com" } }'

In production

What people build with it.

Visual Regression Testing

Send URLs of staging and production environments to compare layouts. Use the images to detect unintended UI changes or layout breaks during the CI/CD process.

Content Archiving

Capture full-page renders of news articles, social media posts, or legal notices. This creates a permanent visual record of web content as it appeared at a specific point in time.

SERP Monitoring

Render search engine result pages using mobile and desktop agents. Analyze ad placements, local snippets, and organic rankings across different geographic locales.

Choosing parameters

Which options matter.

The table below lists what exists. These are the calls worth making deliberately.

waitUntil
Use network-idle for standard sites, but prefer mutation-idle or visible-content for heavy SPAs to ensure data is actually rendered before the shot.
hideSelectors
Pass an array of CSS selectors to strip away overlays. This is the most effective way to remove sticky headers or consent dialogs that obscure the main content.
fullPage
Enabling this will force the browser to scroll and calculate the total height. For extremely long pages, you must increase the timeout parameter to prevent premature termination.

Alternatives

When to use something else.

A page that pretends it has no alternatives reads as an advert. These are the other real options.

Local Playwright Instance

Offers maximum control over the browser lifecycle but requires significant dev-ops work to maintain and scale.

OS-level Screenshot Utilities

Zero cost for manual local testing but impossible to automate for thousands of remote URLs.

Before you integrate

What it does not do.

The boundaries are as useful as the features. These are the ones worth knowing up front.

Interactive states

The API takes a snapshot of the current state; it cannot perform multi-step interactions like clicking buttons or filling forms before the capture.

Canvas and WebGL

Complex 3D renders or hardware-accelerated canvas elements may occasionally fail to render if they rely on specific GPU drivers not present in the headless environment.

Streaming content

The endpoint returns a static image; it does not support capturing frames from auto-playing video or live streaming media.

Reference

2 credits per call
Endpoint
POST https://automatio.ai/api/v1/query
Tool ID
web_screenshot

Parameters

NameTypeRequiredDescription
urlstringThe URL of the website to screenshot (e.g., "https://example.com")
viewportobjectOptional viewport size. Defaults to 1920x1080 (standard widescreen)
device"desktop" | "tablet" | "mobile"Device preset: desktop 1920x1080, tablet 820x1180, mobile 390x844 with touch emulation. An explicit viewport takes precedence.
fullPagebooleanWhen true, captures the entire scrollable page height instead of just the visible viewport. Defaults to false.
hideSelectorsstring[]CSS selectors for elements hidden before capture, e.g. cookie banners or chat widgets.
darkModebooleanWhen true, renders the page with the dark colour scheme preference.
waitForSelectorstringCSS selector to wait for before capturing. Ignored if the element never appears.
waitUntil"visible-content" | "mutation-idle" | "resource-idle" | "media-idle" | "network-idle"How long to let the page settle before capturing.
timeoutnumberSeconds to wait for the page before giving up. Defaults to 15, maximum 180.
localestringBrowser locale for the page, e.g. "de-DE".
userAgentstringOverride the browser User-Agent string.
noCachebooleanWhen true, bypasses any cached copy and renders the page fresh.
assertStatusCodenumberWhen set, the capture fails unless the page returns this HTTP status, e.g. 200.

The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.

Frequently Asked Questions

Find answers to common questions about Screenshot API

More than just prompts

Supercharge your workflow with AI Automation

Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.

AI Agents
Web Automation
Smart Workflows