Capture website screenshot
web_screenshot_captureCapture a screenshot of a public web page URL as a hosted image artifact.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Web page URL to fetch. | |
| delay | No | Extra settle delay in milliseconds after load (0–10000). | |
| format | No | Output image format. Default: png. | png |
| region | No | Optional ISO 3166-1 alpha-2 country for geo-located rendering (+1 credit). | |
| quality | No | JPEG/WebP quality 1–100. Invalid when format is png. | |
| waitFor | No | CSS selector to wait for before capturing. | |
| blockAds | No | Block ads and trackers during render. Default: true. | |
| cacheTtl | No | Optional Redis artifact-cache TTL in seconds (60–604800). Must stay strictly below the 7-day object lifetime. | |
| darkMode | No | Request prefers-color-scheme: dark. Default: false. | |
| fullPage | No | When true, capture the full scrollable page. Default: false (viewport). | |
| response | No | Delivery mode. `url` (default) returns a hosted CDN URL valid for 7 days. `base64` returns the image bytes inline when small enough. | url |
| selector | No | CSS selector to clip the screenshot to a single element. Cannot be combined with fullPage. | |
| cacheMode | No | Cache behavior. `enabled`: read from cache if present, else fetch and write to cache. `bypass`: always fetch fresh, ignoring and not updating the cache. `write_only`: always fetch fresh, but write the result to cache without reading from it first. Default: `enabled`. | enabled |
| waitUntil | No | Navigation wait condition. `networkidle` is bounded and resolves on idle or a short cap, whichever comes first. Default: load. | load |
| viewportWidth | No | Viewport width in CSS pixels. Default: 1280. | |
| viewportHeight | No | Viewport height in CSS pixels. Default: 800. | |
| deviceScaleFactor | No | Device scale factor (1–3). Default: 1. | |
| blockCookieBanners | No | Dismiss/block cookie consent banners. Default: true. |