// screenshot api Alpha

Capture a web page as a PNG

Capture the viewport or the full page in an isolated browser. Receive a PNG download URL, 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 go10 free calls, no card

// live playground

Capture a screenshot

The key below is created for this browser with 10 free calls and works on every Litescrape endpoint. Results are drawn the way the source shows them, with the JSON one click away.

Your API Key

Verifying browser…

Try it live.

URL urlPublic http:// or https:// URL, up to 8,192 characters, with a standard port and no credentials.

More options

Screenshot

Capture a PNG and receive its authenticated download URL.

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

Browser

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

Respond timing respond_timingPage readiness condition before responding.Wait for selector wait_for_selectorCSS selector to wait for after navigation, up to 2,048 characters.Page timeout page_timeoutSeconds from 1 through 180 for browser operations.Locale localeBrowser locale, such as en-US.User agent user_agentOptional User-Agent, up to 1,024 characters.Referer refererOptional HTTP(S) referer.Remove overlays remove_overlayRemove cookie banners and modal overlays before capture.Detach invisible elements detach_invisiblesDrop display:none elements before capture.Expected status assert_status_codeRequire this origin HTTP status, from 100 through 599.Robots user agent robots_txtCheck robots.txt for this user agent and reject disallowed URLs.

# pip install httpx
import httpx

response = httpx.get(
    "https://api.litescrape.com/api/web/screenshot",
    params={
        "url": "https://litescrape.com",
    },
    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_url
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.

One PNG URL

Download screenshot_url with your API key. Images are retained for 7 days; keys with ZDR enabled cannot capture screenshots.

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 10 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