URL Screenshot Generator

Pricing

Rating

Developer

Actor stats

Categories

Share

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:

{
"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:

{
"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.