// screenshot api Alpha

Capture a web page as a PNG

Capture the viewport or the full page in an isolated browser. Receive a base64 PNG, with support for your own cookies, viewport, scripts and page readiness controls.

Try it with your free key Read the docs →

$0.15 / 1K requestsPay as you go5 free calls, no card

// live playground

Capture a screenshot

Your API Key

Verifying browser…

Try it live.

URL urlPublic HTTP(S) URL to capture, 1-8,192 characters. Include http:// or https://; bare domains are rejected. The host must be public, on port 80 or 443, without embedded credentials. Minimum characters: 1 Maximum characters: 8192

More options

Screenshot

Capture a PNG and receive its authenticated download URL.

Full page full_pageCapture the full page when true. The default, false, captures the viewport.

Browser

For custom cookies, viewport dimensions and scripts, send a POST request with a JSON body. See the Screenshot API reference.

Remove overlays remove_overlayRemove modal and cookie-banner overlays from the page.Detach invisible elements detach_invisiblesDrop display:none elements from the page.Wait for selector wait_for_selectorCSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors. Minimum characters: 1 (string) Maximum characters: 2048 (string) Minimum items: 1 (array) Maximum items: 16 (array)User agent user_agentUser-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own. Minimum characters: 1 Maximum characters: 1024Page timeout page_timeoutSeconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout. Minimum: 1 Maximum: 180Locale localeBrowser locale as a language tag, 2-64 characters. Defaults to the browser's own. Minimum characters: 2 Maximum characters: 64 Pattern: ^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$Referer refererHTTP(S) URL sent as the Referer. Minimum characters: 1 Maximum characters: 8192Expected status assert_status_codeExpected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture. Minimum: 100 Maximum: 599Robots user agent robots_txtUser agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected. Minimum characters: 1 Maximum characters: 256Respond timing respond_timingPage readiness condition to reach before responding.

# pip install httpx
import httpx

response = httpx.get(
    "https://ecll-litescrape-v3--site-api-web.modal.run/api/web/screenshot",
    params={
        "url": "https://ecll-litescrape-v3--site-api-web.modal.run",
    },
    headers={"Authorization": "Bearer ls_live_your_key"},
    timeout=120,
)
response.raise_for_status()
print(response.json())

Ready

Run the request to draw its results here. This endpoint returns:

url
title
screenshot_base64
full_page

// what you get

What the Screenshot API returns

Viewport or full page

Set full_page=true to capture the whole page. The default captures the viewport.

Bring your own cookies

Pass set_cookies in a JSON POST body to capture a page using your session.

Control the browser

Set viewport dimensions, mobile emulation, locale, user agent, and page or frame scripts.

Wait for the page

Use wait_for_selector and respond_timing to choose when to capture.

Base64 PNG

The response includes screenshot_base64. Decode the base64 string to PNG bytes, or display it with a data URL prefix.

Track screenshot usage

Screenshot calls appear in your API usage and use your Litescrape key, balance and concurrency allowance.

// use cases

What teams build with it

01
Visual monitoring
Capture pricing pages, dashboards or status pages and compare them over time.
02
Check responsive layouts
Capture a page with desktop or mobile viewport settings.
03
Capture your signed-in session
Supply your own cookies and wait for the content you need before capture.

// same key

More Web APIs

Start pulling Screenshot data in five minutes.

Your first 5 calls are free. Top up the same key from $10 whenever you need more.

Get your API key Read the docs →

Litescrape sells to AI agents - live prices and self-serve payment