URL Screenshot Generator This actor visits a list of websites and captures screenshots, then returns input urls with attached links to taken screenshots. ## Features - Capture full-page screenshots (JPG or PNG). - Optional cropping via topOffset and height. - Configurable viewport width, page waitUntil, delay, and timeout. ## Inputs - urls: array (required) - Description: List of sources. Each item should be an object like { "url": "https://example.com" }. You can provide URLs manually, upload a file, or use a Google Sheet. - format: string (required) - Allowed values: jpg (default), png - Description: Output image format. jpg uses a quality of 80. - waitUntil: string (required) - Allowed values: load (default), domcontentloaded, networkidle0 - Description: Puppeteer page.goto waitUntil option; controls when the page is considered loaded. - delay: number (required) - Unit: milliseconds - Default: 500 - Description: Wait this long after navigation before taking the screenshot. Useful for client-side rendering or animations. - timeout: number (required) - Unit: milliseconds - Default: 30000 - Description: Navigation timeout for page.goto. - width: number (required) - Unit: pixels - Default: 1280 - Description: Viewport width used when launching the browser. - height: number (optional) - Unit: pixels - Description: When specified together with topOffset, defines a rectangular crop height to extract from the full-page screenshot. - topOffset: number (optional) - Unit: pixels - Description: How many pixels from the top to begin the crop. Combined with height to extract a portion of the page. - proxyConfig: object (optional, recommended) - Description: Proxy configuration for crawling. Use Apify Proxy (recommended) or custom proxies to avoid throttling and geo-based blocks. ### Required fields The schema marks the following fields as required: urls, format, timeout, delay, width, waitUntil. ## Example input Example JSON you can paste into the actor input panel: json { "urls": [ { "url": "https://example.com" }, { "url": "https://roomjs.com" } ], "format": "jpg", "waitUntil": "load", "delay": 500, "timeout": 30000, "width": 1280, "topOffset": 0, "height": 800, "proxyConfig": { "useApifyProxy": true } } Adjust or remove topOffset / height if you want full-page screenshots instead of a cropped fragment. ## Output - Screenshots are saved into the default Key-Value Store (Actor.setValue). Each image record key is generated from the page URL and a timestamp. - For every stored screenshot the actor pushes a dataset record with the shape: json { "url": "https://example.com", "screenshotUrl": "https://api.apify.com/v2/key-value-stores/<STORE_ID>/records/<KEY>" } ## Notes & Tips - Use the proxyConfig to avoid IP blocks for large crawls. The schema pre-fills useApifyProxy: true. - If you need a very tall viewport for full-length screenshots, the actor takes a full-page screenshot and then extracts a portion when topOffset/height are provided. - JPG is generally smaller than PNG. Use png if you need lossless screenshots.