FAQ

Screenshot API FAQ

Straight answers about capturing, waiting for dynamic pages, PDFs, AI extraction, and quotas.

General

How do I take a screenshot of a website with an API?

Send a GET request to /v1/screenshot with a url parameter and your API key. The response streams back the image bytes directly — no polling, no job queue, no SDK required. GET /v1/screenshot reference

Do I need Puppeteer or my own headless Chrome server?

No. That's the whole point of a rendering API — you send a URL and get bytes back, and we run and patch the browsers, handle concurrency, and absorb the memory and cold-start problems that come with running Chrome yourself.

Capturing

How do I capture a full-page screenshot of a long, lazy-loaded page?

Set full_page=true, and pair it with wait_until=networkidle, a wait_for selector, or a fixed delay so lazy-loaded images and sections have actually loaded before the capture happens. Full-page screenshots of lazy-loaded pages

Can I screenshot one element instead of the whole page?

Yes — pass a CSS selector as the selector parameter and the capture is cropped to that element instead of the viewport or full page. GET /v1/screenshot reference

Can I screenshot pages behind a login?

Not today — the API doesn't accept cookies, auth headers, or a login step to inject into the render, so it can only capture publicly reachable pages.

PDFs

Can the same endpoint return a PDF instead of an image?

Yes — set format=pdf on /v1/screenshot and you get a PDF of the rendered page instead of an image, from the exact same request shape. GET /v1/screenshot reference

Waiting & timing

How do I make the API wait until the page has finished loading?

Use wait_until to pick when navigation is considered done (load, domcontentloaded, or networkidle), wait_for to block on a specific CSS selector appearing, and delay for a fixed extra pause. Most pages need a combination of the three. wait_until vs wait_for vs delay

AI extraction

Can I get structured data instead of an image?

Yes — GET /v1/extract takes a url and a prompt or a JSON schema, and returns structured JSON extracted from the page with AI. Available on the Starter and Growth plans. AI data extraction

Plans & quotas

What counts as one render, and what happens when I hit my monthly quota?

Each screenshot or PDF call counts as one render; AI extraction counts against a separate quota. Free plans are capped at their quota. Paid plans can burst up to 3x their included quota as billed overage before requests are rejected until the next billing period. Rate limits & quotas

Legal