urlstring
URL to capture (required if no html/markdown)
htmlstring
Raw HTML to render (required if no url/markdown)
markdownstring
Render Markdown content as a screenshot
widthinteger
Viewport width in pixels (default: 1280)
heightinteger
Viewport height in pixels (default: 720)
viewportDevicestring
Device preset for viewport emulation (e.g. "iphone_14_pro", "macbook_pro_14"). Use list_devices to see all presets.
viewportMobileboolean
Enable mobile meta viewport emulation
viewportHasTouchboolean
Enable touch event emulation
viewportLandscapeboolean
Landscape orientation
deviceScaleFactornumber
Device pixel ratio, use 2 for retina (default: 1)
formatenum
Image format (default: png)
qualityinteger
JPEG/WebP quality 1-100 (default: 80)
omitBackgroundboolean
Transparent background (PNG/WebP only)
fullPageboolean
Capture the full scrollable page (default: false)
fullPageScrollboolean
Auto-scroll page before capture to trigger lazy-loaded images
fullPageScrollDelayinteger
Delay between scroll steps in ms (default: 400)
fullPageScrollByinteger
Pixels to scroll per step (default: viewport height)
fullPageMaxHeightinteger
Maximum pixel height cap for full-page captures
selectorstring
CSS selector to capture a specific element
clipobject
Crop region { x, y, width, height } in pixels
delayinteger
Milliseconds to wait before capture (default: 0)
waitUntilenum
When to consider navigation finished (default: networkidle2)
waitForSelectorstring
Wait for this CSS selector to appear before capturing
navigationTimeoutinteger
Navigation timeout in ms (default: 25000)
darkModeboolean
Emulate dark color scheme (default: false)
reducedMotionboolean
Emulate prefers-reduced-motion to disable animations
mediaTypeenum
Emulate CSS media type
timeZonestring
Override browser timezone (e.g. "America/New_York")
geolocationobject
Emulate geolocation { latitude, longitude, accuracy? }
userAgentstring
Override the browser User-Agent string
cookiesarray
Cookies to set — array of "name=value" strings or { name, value, domain? } objects
headersobject
Extra HTTP headers to send with the request
authorizationstring
Authorization header value (e.g. "Bearer <token>")
bypassCSPboolean
Bypass Content-Security-Policy on the page
hideSelectorsstring[]
Array of CSS selectors to hide before capture
clickstring
CSS selector to click before capturing the screenshot
injectCssstring
Custom CSS to inject before capturing (max 50KB)
injectJsstring
Custom JavaScript to execute before capturing (max 50KB)
blockBannersboolean
Hide cookie consent banners (default: false)
blockAdsboolean
Block advertisements on the page
blockChatsboolean
Block live chat widgets on the page
blockTrackersboolean
Block tracking scripts on the page
blockRequestsstring[]
URL patterns to block (array of strings)
blockResourcesstring[]
Resource types to block (e.g. ["image", "font"])
extractMetadataboolean
Extract page metadata (title, description, OG tags) alongside the screenshot
styleobject
Screenshot styling options — add a macOS/Windows frame, gradient/glass background, shadow, and rounded corners. Use the "theme" shortcut for one-click presets, or customize individual properties.
session_idstring
Persistent session ID (Starter+ only). Reuse a live browser page created with create_session — browser state (cookies, localStorage, auth) carries over from previous requests in this session.