Get Screenshot

Capture full-page or viewport screenshots of dynamic, JavaScript-rendered pages in the Scraper API, with real browser rendering enabled by default.

Overview

Selecting Get Screenshot in the Scraper API Use Case panel pre-configures the Scraper API environment specifically for visual page capture. When this preset is active, the Scraper API enables real browser rendering (browserRendering=true) by default so you can visually verify how dynamic web pages, client-side scripts, and layout elements render.

You can toggle between capturing the first viewport (top) or rendering the full scrollable page (full), or set a custom viewport size as <width>x<height> with an optional -<zoom> percent, such as 1280x800 or 1920x1080-75 (width and height 100–3840 px, zoom 25–300). The screenshot is always a PNG.

Practical Applications

  • Visual QA & Deployment Audits: Verify visual layout integrity across dynamic responsive viewports after deployments or design updates.
  • Compliance & Legal Archiving: Maintain time-stamped visual proof of pricing, terms of service, disclosures, or ad placements.
  • Competitor UI & Campaign Tracking: Monitor visual changes on competitor landing pages, promotional banners, and checkout flows over time.
  • Scraper & Extraction Debugging: Inspect the exact page state when data extraction fails—instantly spot cookie banners, error pages, or unexpected layouts.
  • Automated Previews & Dashboards: Generate real-time page thumbnails and visual previews for internal dashboards, link previews, or reports.

Advanced settings

SettingDescriptionCommon Use CaseDefault
Warm startOpens the site's home page first to warm the session before loading the target URL.Sites that block direct visits to deep pages.Off
Wait for selectorWaits until a specific element appears before returning the page. Turns on browser rendering.Content that loads asynchronously after the initial page load.None
Wait for delayWaits extra seconds after the page loads, from 0 to 30. Turns on browser rendering.Pages that keep loading content after the initial load.None
ActionUse this to route the request to a specific scraper action or simply flag it.If you want to separate the analytic for a domain.Off

Default Parameters

ParameterDescription
browserRendering=trueIn this use case, Render JavaScript default to On
timeoutDefault to 300
screenshotDefault to full
super=trueIn this use case, Super defaults to On.

Use cache

Serve a recent result when one exists. With Use cache on, the Scraper API returns a cached result of the same request when it is newer than the selected age. A cached result costs the same tokens as the original scrape.

Choose how old a cached result can be, and pass it as maxAge in milliseconds:

Cache agemaxAge
1 hour3600000
1 day86400000
3 days259200000
7 days604800000
Request with a 1-day cache
curl --location 'https://api.mrscraper.com?token={MRSCRAPER_API_TOKEN}&maxAge=86400000&browserRendering=true&timeout=300&geoCode=us&screenshot=full&super=true&proxyCountry=us&url=https%3A%2F%2Fwww.walmart.com%2Fsearch%3Fq%3Dtable%2520lamps' \
  -H 'x-api-token: {MRSCRAPER_API_TOKEN}'

Example

Request

Scrape https://www.walmart.com/search?q=table%20lamps with default setting

Request
curl --location 'https://api.mrscraper.com?token={MRSCRAPER_API_TOKEN}&browserRendering=true&timeout=300&geoCode=us&screenshot=full&super=true&proxyCountry=us&url=https%3A%2F%2Fwww.walmart.com%2Fsearch%3Fq%3Dtable%2520lamps' \
  -H 'x-api-token: {MRSCRAPER_API_TOKEN}'

Response

The response is a JSON object with the page html and the base64-encoded screenshot:

Response
{
  "html": "<!DOCTYPE html>...</html>",
  "screenshot": "iVBORw0KGgoAAAANSUhEUgAA..."
}

Decoded screenshot:

On this page