Nimbryxo Studio
Actors/Complete Page Capture - Screenshot & PDF

Complete Page Capture - Screenshot & PDF

Capture complete full-page screenshots or PDFs of any URL list. Scrolls lazy content, waits for images and fonts, removes fixed headers and consent overlays, emulates real devices, and reports blocks and truncation instead of returning a broken image.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
urlsarrayrequiredWeb pages to capture. Each item can be a URL object or a plain URL string. Bare domains such as example.com are accepted and use https.
formatstringoptionalPNG is lossless, JPEG and WebP are smaller, PDF produces a printable document. WebP conversion uses Pillow after the browser capture.
qualityintegeroptionalQuality for JPEG and WebP output (1-100). Ignored for PNG and PDF.
Show all input fields
FieldTypeRequiredDescription
urlsarrayrequiredWeb pages to capture. Each item can be a URL object or a plain URL string. Bare domains such as example.com are accepted and use https.
formatstringoptionalPNG is lossless, JPEG and WebP are smaller, PDF produces a printable document. WebP conversion uses Pillow after the browser capture.
qualityintegeroptionalQuality for JPEG and WebP output (1-100). Ignored for PNG and PDF.
fullPagebooleanoptionalCapture the full scrollable page. Turn off to capture only the visible viewport. A selector overrides this option.
selectorstringoptionalOptional CSS selector. When set, captures only that element and ignores fullPage. Example: main, #pricing, article.
devicestringoptionalDevice preset. Custom uses the viewport width, height and scale factor below. Presets emulate a real mobile or desktop browser.
viewportWidthintegeroptionalBrowser viewport width in pixels when Device is Custom.
viewportHeightintegeroptionalBrowser viewport height in pixels when Device is Custom.
deviceScaleFactorintegeroptionalPixel density for Device=Custom: 1 is standard, 2 is retina, 3 is high-DPI mobile. Device presets use their own scale factor.
colorSchemestringoptionalRequest the site's light or dark theme through prefers-color-scheme where the site supports it.
localestringoptionalLocale used for navigator.language and localized pages.
waitUntilstringoptionalNavigation readiness. DOM content loaded is the fastest reliable default; network idle can stall on analytics-heavy sites.
waitForSelectorstringoptionalOptional CSS selector to wait for before capture. Useful for single-page apps. Fails the URL if the element never becomes visible.
waitForImagesbooleanoptionalWait up to 5 seconds for images to finish loading after scrolling. Incomplete images are reported in warnings.
waitForFontsbooleanoptionalWait up to 5 seconds for web fonts to finish loading.
delayintegeroptionalAdditional milliseconds to wait after navigation before scrolling or capturing.
scrollToBottombooleanoptionalScroll through the page in steps to trigger lazy images, infinite-scroll widgets and content-visibility sections before capture.
maxScrollStepsintegeroptionalStop after this many scroll steps. Prevents infinite-scroll pages from running forever. A cap hit sets truncated=true in the record.
scrollStepPxintegeroptionalPixels to scroll per step. Smaller steps trigger more IntersectionObserver content but take longer.
delayAfterScrollingintegeroptionalMilliseconds to wait after scrolling and before capture. Only used when scrolling is enabled.
waitUntilNetworkIdleAfterScrollbooleanoptionalAfter scrolling, wait until the network is idle before capture. Uses the timeout below.
waitUntilNetworkIdleAfterScrollTimeoutintegeroptionalMaximum milliseconds to wait for network idle after scrolling.
hideFixedElementsbooleanoptionalHide real fixed headers, full-screen overlays and chat widgets before capture. Sticky content blocks are left in place. Default off because resetting to the top already prevents repeated headers on most pages.
cookieBannerActionstringoptionalHide common cookie and consent overlays, click Accept first, or leave them untouched.
selectorsToHidestringoptionalComma or newline separated CSS selectors for extra elements to hide before capture. Example: .newsletter-popup, #chat-widget
pdfPageSizestringoptionalPaper size for PDF output. Web page width preserves the previous 1280 px wide / Letter-height behavior.
pdfLandscapebooleanoptionalUse landscape orientation for PDF pages.
pdfPrintBackgroundbooleanoptionalInclude CSS backgrounds, colors and images in the PDF.
pdfFitOnePagebooleanoptionalCreate one tall PDF page instead of paginated paper. Overrides the paper height but keeps the selected margins.
pdfMarginstringoptionalPage margins for PDF output.
maxConcurrencyintegeroptionalHow many URLs to capture in parallel. Keep at 1 for long pages at 2048 MB; higher values need more memory.
maxRetriesintegeroptionalRetry transient navigation failures and block pages. Retries use the AUTO datacenter proxy when no user proxy is configured.
navigationTimeoutSecsintegeroptionalMaximum seconds to wait for navigation and selector readiness per URL.
maxPageHeightintegeroptionalClip full-page images at this CSS height. 0 means unlimited. PDFs keep their full document height and ignore this limit. Truncation is reported in the record.
proxyConfigurationobjectoptionalOptional proxy override. The actor starts direct and uses an Apify AUTO datacenter proxy only after a real block when this is empty. Residential is never selected automatically.

Download the published input schema

View complete JSON
{
  "description": "Capture complete full-page screenshots or PDFs of any list of URLs. The actor scrolls lazy content, waits for images and fonts, removes fixed headers and consent overlays, and reports blocks and truncation honestly.",
  "properties": {
    "colorScheme": {
      "default": "no-preference",
      "description": "Request the site's light or dark theme through prefers-color-scheme where the site supports it.",
      "editor": "select",
      "enum": [
        "no-preference",
        "light",
        "dark"
      ],
      "enumTitles": [
        "Follow the site",
        "Force light",
        "Force dark"
      ],
      "prefill": "no-preference",
      "title": "Color scheme",
      "type": "string"
    },
    "cookieBannerAction": {
      "default": "hide",
      "description": "Hide common cookie and consent overlays, click Accept first, or leave them untouched.",
      "editor": "select",
      "enum": [
        "hide",
        "accept",
        "off"
      ],
      "enumTitles": [
        "Hide banners (recommended)",
        "Click Accept",
        "Leave banners"
      ],
      "prefill": "hide",
      "title": "Consent banners",
      "type": "string"
    },
    "delay": {
      "default": 0,
      "description": "Additional milliseconds to wait after navigation before scrolling or capturing.",
      "maximum": 600000,
      "minimum": 0,
      "prefill": 0,
      "title": "Extra delay after load",
      "type": "integer"
    },
    "delayAfterScrolling": {
      "default": 1000,
      "description": "Milliseconds to wait after scrolling and before capture. Only used when scrolling is enabled.",
      "maximum": 600000,
      "minimum": 0,
      "prefill": 0,
      "title": "Delay after scrolling",
      "type": "integer"
    },
    "device": {
      "default": "custom",
      "description": "Device preset. Custom uses the viewport width, height and scale factor below. Presets emulate a real mobile or desktop browser.",
      "editor": "select",
      "enum": [
        "custom",
        "desktop",
        "desktop_hd",
        "laptop",
        "tablet",
        "ipad",
        "iphone_15",
        "iphone_se",
        "pixel_8",
        "galaxy_s23"
      ],
      "enumTitles": [
        "Custom viewport",
        "Desktop 1280x1080",
        "Desktop HD 1920x1080",
        "Laptop 1366x768",
        "Tablet 768x1024",
        "iPad 1024x1366",
        "iPhone 15",
        "iPhone SE",
        "Pixel 8",
        "Galaxy S23"
      ],
      "prefill": "custom",
      "sectionCaption": "Device & rendering",
      "sectionDescription": "Viewport, scale, color scheme and language for the browser.",
      "title": "Device",
      "type": "string"
    },
    "deviceScaleFactor": {
      "default": 1,
      "description": "Pixel density for Device=Custom: 1 is standard, 2 is retina, 3 is high-DPI mobile. Device presets use their own scale factor.",
      "maximum": 3,
      "minimum": 1,
      "prefill": 1,
      "title": "Device scale factor",
      "type": "integer"
    },
    "format": {
      "default": "png",
      "description": "PNG is lossless, JPEG and WebP are smaller, PDF produces a printable document. WebP conversion uses Pillow after the browser capture.",
      "editor": "select",
      "enum": [
        "png",
        "jpeg",
        "webp",
        "pdf"
      ],
      "enumTitles": [
        "PNG image",
        "JPEG image",
        "WebP image",
        "PDF document"
      ],
      "prefill": "png",
      "title": "Output format",
      "type": "string"
    },
    "fullPage": {
      "default": true,
      "description": "Capture the full scrollable page. Turn off to capture only the visible viewport. A selector overrides this option.",
      "prefill": true,
      "title": "Capture the whole page",
      "type": "boolean"
    },
    "hideFixedElements": {
      "default": false,
      "description": "Hide real fixed headers, full-screen overlays and chat widgets before capture. Sticky content blocks are left in place. Default off because resetting to the top already prevents repeated headers on most pages.",
      "prefill": false,
      "title": "Hide fixed headers and overlays",
      "type": "boolean"
    },
    "locale": {
      "default": "en-US",
      "description": "Locale used for navigator.language and localized pages.",
      "editor": "select",
      "enum": [
        "en-US",
        "en-GB",
        "de-DE",
        "fr-FR",
        "es-ES",
        "it-IT",
        "pt-BR",
        "nl-NL",
        "pl-PL",
        "ru-RU",
        "tr-TR",
        "ar-SA",
        "hi-IN",
        "ja-JP",
        "zh-CN",
        "ko-KR"
      ],
      "enumTitles": [
        "English (US)",
        "English (UK)",
        "German",
        "French",
        "Spanish",
        "Italian",
        "Portuguese (Brazil)",
        "Dutch",
        "Polish",
        "Russian",
        "Turkish",
        "Arabic",
        "Hindi",
        "Japanese",
        "Chinese (Simplified)",
        "Korean"
      ],
      "prefill": "en-US",
      "title": "Browser language",
      "type": "string"
    },
    "maxConcurrency": {
      "default": 1,
      "description": "How many URLs to capture in parallel. Keep at 1 for long pages at 2048 MB; higher values need more memory.",
      "maximum": 5,
      "minimum": 1,
      "prefill": 1,
      "sectionCaption": "Reliability",
      "sectionDescription": "Retries, timeouts and page-size limits.",
      "title": "Concurrent URLs",
      "type": "integer"
    },
    "maxPageHeight": {
      "default": 0,
      "description": "Clip full-page images at this CSS height. 0 means unlimited. PDFs keep their full document height and ignore this limit. Truncation is reported in the record.",
      "maximum": 200000,
      "minimum": 0,
      "prefill": 0,
      "title": "Maximum page height",
      "type": "integer"
    },
    "maxRetries": {
      "default": 1,
      "description": "Retry transient navigation failures and block pages. Retries use the AUTO datacenter proxy when no user proxy is configured.",
      "maximum": 5,
      "minimum": 0,
      "prefill": 0,
      "title": "Retries per URL",
      "type": "integer"
    },
    "maxScrollSteps": {
      "default": 400,
      "description": "Stop after this many scroll steps. Prevents infinite-scroll pages from running forever. A cap hit sets truncated=true in the record.",
      "maximum": 1000,
      "minimum": 1,
      "prefill": 400,
      "title": "Maximum scroll steps",
      "type": "integer"
    },
    "navigationTimeoutSecs": {
      "default": 60,
      "description": "Maximum seconds to wait for navigation and selector readiness per URL.",
      "maximum": 300,
      "minimum": 5,
      "prefill": 60,
      "title": "Navigation timeout",
      "type": "integer"
    },
    "pdfFitOnePage": {
      "default": false,
      "description": "Create one tall PDF page instead of paginated paper. Overrides the paper height but keeps the selected margins.",
      "prefill": false,
      "title": "Fit the whole page on one PDF page",
      "type": "boolean"
    },
    "pdfLandscape": {
      "default": false,
      "description": "Use landscape orientation for PDF pages.",
      "prefill": false,
      "title": "Landscape PDF",
      "type": "boolean"
    },
    "pdfMargin": {
      "default": "none",
      "description": "Page margins for PDF output.",
      "editor": "select",
      "enum": [
        "none",
        "narrow",
        "normal",
        "wide"
      ],
      "enumTitles": [
        "None",
        "Narrow (0.25 in)",
        "Normal (0.5 in)",
        "Wide (1 in)"
      ],
      "prefill": "none",
      "title": "PDF margin",
      "type": "string"
    },
    "pdfPageSize": {
      "default": "web",
      "description": "Paper size for PDF output. Web page width preserves the previous 1280 px wide / Letter-height behavior.",
      "editor": "select",
      "enum": [
        "web",
        "a4",
        "letter",
        "legal",
        "a3",
        "a5",
        "tabloid"
      ],
      "enumTitles": [
        "Web page width (current behavior)",
        "A4",
        "Letter",
        "Legal",
        "A3",
        "A5",
        "Tabloid"
      ],
      "prefill": "web",
      "sectionCaption": "PDF options",
      "sectionDescription": "Only used when Output format is PDF.",
      "title": "PDF page size",
      "type": "string"
    },
    "pdfPrintBackground": {
      "default": true,
      "description": "Include CSS backgrounds, colors and images in the PDF.",
      "prefill": true,
      "title": "Print backgrounds",
      "type": "boolean"
    },
    "proxyConfiguration": {
      "description": "Optional proxy override. The actor starts direct and uses an Apify AUTO datacenter proxy only after a real block when this is empty. Residential is never selected automatically.",
      "editor": "proxy",
      "sectionCaption": "Advanced",
      "title": "Proxy configuration",
      "type": "object"
    },
    "quality": {
      "default": 85,
      "description": "Quality for JPEG and WebP output (1-100). Ignored for PNG and PDF.",
      "maximum": 100,
      "minimum": 1,
      "prefill": 85,
      "title": "Image quality",
      "type": "integer"
    },
    "scrollStepPx": {
      "default": 250,
      "description": "Pixels to scroll per step. Smaller steps trigger more IntersectionObserver content but take longer.",
      "maximum": 2000,
      "minimum": 100,
      "prefill": 250,
      "title": "Scroll step",
      "type": "integer"
    },
    "scrollToBottom": {
      "default": true,
      "description": "Scroll through the page in steps to trigger lazy images, infinite-scroll widgets and content-visibility sections before capture.",
      "prefill": false,
      "sectionCaption": "Scrolling & cleanup",
      "sectionDescription": "Controls for lazy content, fixed elements and consent overlays.",
      "title": "Scroll to load lazy content",
      "type": "boolean"
    },
    "selector": {
      "description": "Optional CSS selector. When set, captures only that element and ignores fullPage. Example: main, #pricing, article.",
      "editor": "textfield",
      "title": "Capture one element",
      "type": "string"
    },
    "selectorsToHide": {
      "description": "Comma or newline separated CSS selectors for extra elements to hide before capture. Example: .newsletter-popup, #chat-widget",
      "editor": "textarea",
      "title": "Additional CSS selectors to hide",
      "type": "string"
    },
    "urls": {
      "description": "Web pages to capture. Each item can be a URL object or a plain URL string. Bare domains such as example.com are accepted and use https.",
      "editor": "requestListSources",
      "prefill": [
        {
          "url": "https://www.apify.com/"
        }
      ],
      "title": "URLs to capture",
      "type": "array"
    },
    "viewportHeight": {
      "default": 1080,
      "description": "Browser viewport height in pixels when Device is Custom.",
      "maximum": 4320,
      "minimum": 100,
      "prefill": 1080,
      "title": "Viewport height",
      "type": "integer"
    },
    "viewportWidth": {
      "default": 1280,
      "description": "Browser viewport width in pixels when Device is Custom.",
      "maximum": 3840,
      "minimum": 100,
      "prefill": 1280,
      "title": "Viewport width",
      "type": "integer"
    },
    "waitForFonts": {
      "default": true,
      "description": "Wait up to 5 seconds for web fonts to finish loading.",
      "prefill": true,
      "title": "Wait for fonts",
      "type": "boolean"
    },
    "waitForImages": {
      "default": true,
      "description": "Wait up to 5 seconds for images to finish loading after scrolling. Incomplete images are reported in warnings.",
      "prefill": false,
      "title": "Wait for images",
      "type": "boolean"
    },
    "waitForSelector": {
      "description": "Optional CSS selector to wait for before capture. Useful for single-page apps. Fails the URL if the element never becomes visible.",
      "editor": "textfield",
      "title": "Wait for element",
      "type": "string"
    },
    "waitUntil": {
      "default": "load",
      "description": "Navigation readiness. DOM content loaded is the fastest reliable default; network idle can stall on analytics-heavy sites.",
      "editor": "select",
      "enum": [
        "load",
        "domcontentloaded",
        "networkidle",
        "commit"
      ],
      "enumTitles": [
        "Page load event",
        "DOM content loaded (recommended)",
        "Network idle (can stall)",
        "Navigation committed"
      ],
      "prefill": "domcontentloaded",
      "sectionCaption": "Loading & timing",
      "sectionDescription": "Controls for deciding when the page and its assets are ready.",
      "title": "Wait until",
      "type": "string"
    },
    "waitUntilNetworkIdleAfterScroll": {
      "default": false,
      "description": "After scrolling, wait until the network is idle before capture. Uses the timeout below.",
      "prefill": false,
      "title": "Wait for network idle after scrolling",
      "type": "boolean"
    },
    "waitUntilNetworkIdleAfterScrollTimeout": {
      "default": 15000,
      "description": "Maximum milliseconds to wait for network idle after scrolling.",
      "maximum": 120000,
      "minimum": 1000,
      "prefill": 1000,
      "title": "Network idle timeout",
      "type": "integer"
    }
  },
  "required": [
    "urls"
  ],
  "schemaVersion": 1,
  "title": "Screenshot URL Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
screenshotsstringoptionalDataset containing one result per URL, including status, HTTP status, page title, image dimensions and public file URL.
screenshotFilesstringoptionalKey-value store containing the PNG, JPEG, WebP or PDF files.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "One record per captured URL, with the file link, page metadata, block/error classification and capture evidence.",
  "properties": {
    "screenshotFiles": {
      "description": "Key-value store containing the PNG, JPEG, WebP or PDF files.",
      "template": "{{links.apiDefaultKeyValueStoreUrl}}/records",
      "title": "Capture files",
      "type": "string"
    },
    "screenshots": {
      "description": "Dataset containing one result per URL, including status, HTTP status, page title, image dimensions and public file URL.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Capture results",
      "type": "string"
    }
  },
  "title": "Complete Page Capture Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "blocked": {
            "format": "text",
            "label": "Blocked"
          },
          "fileSizeBytes": {
            "format": "number",
            "label": "Bytes"
          },
          "format": {
            "format": "text",
            "label": "Format"
          },
          "httpStatus": {
            "format": "number",
            "label": "HTTP"
          },
          "imageHeight": {
            "format": "number",
            "label": "Height"
          },
          "imageWidth": {
            "format": "number",
            "label": "Width"
          },
          "pageTitle": {
            "format": "text",
            "label": "Page title"
          },
          "screenshotUrl": {
            "format": "link",
            "label": "Screenshot"
          },
          "startUrl": {
            "format": "link",
            "label": "Input URL"
          },
          "status": {
            "format": "text",
            "label": "Status"
          },
          "timestamp": {
            "format": "text",
            "label": "Timestamp"
          },
          "url": {
            "format": "link",
            "label": "Final URL"
          }
        }
      },
      "title": "Screenshots",
      "transformation": {
        "fields": [
          "startUrl",
          "url",
          "pageTitle",
          "status",
          "httpStatus",
          "blocked",
          "format",
          "imageWidth",
          "imageHeight",
          "fileSizeBytes",
          "screenshotUrl",
          "timestamp"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Complete Page Capture - Screenshot & PDF

Capture complete full-page screenshots or PDFs of any URL list. This actor scrolls lazy content into view, waits for images and fonts, removes fixed headers and consent overlays, supports real device emulation, and tells you when a page was blocked or truncated instead of returning a broken image as a success.

Why this actor

  • Complete captures - scrolls through the page to trigger lazy images and infinite-scroll widgets, then captures with the page reset to the top.
  • Clean captures - can hide fixed headers, overlays and common cookie banners before the shot without deleting sticky content cards.
  • Honest results - reports HTTP status, page title, block reason, truncation, image failures and file metadata for every URL.
  • Real device modes - desktop, laptop, tablet, iPhone, Pixel and Galaxy presets with the right viewport, user agent, touch support and pixel density.
  • Useful formats - PNG, JPEG, WebP and PDF, with PDF paper size, orientation, margins, backgrounds and a one-page mode.
  • Bulk friendly - concurrent captures, bounded retries, per-URL timeouts and a hard cap for very long or infinite pages.

Quick start

{
  "urls": [
    {"url": "https://www.apify.com/"},
    {"url": "https://en.wikipedia.org/wiki/World_War_II"}
  ],
  "format": "png",
  "device": "desktop",
  "scrollToBottom": true
}

Every URL produces one dataset record and one file in the run's key-value store. The screenshotUrl field is a public download link; no Apify token is needed to open it.

Inputs

Field Default What it does
urls - Required. URL list; accepts URL objects or plain strings. Bare domains use https.
format png png, jpeg, webp or pdf.
quality 85 JPEG/WebP quality, 1-100.
fullPage true Capture the whole scrollable page. Turn off for the first screen only.
selector - Capture one element by CSS selector instead of the page.
device custom custom, desktop, desktop_hd, laptop, tablet, ipad, iphone_15, iphone_se, pixel_8, galaxy_s23.
viewportWidth 1280 Width for device=custom, 100-3840.
viewportHeight 1080 Height for device=custom, 100-4320.
deviceScaleFactor 1 Pixel density for device=custom, 1-3.
colorScheme no-preference no-preference, light or dark.
locale en-US Browser language for localized pages.
waitUntil load load, domcontentloaded, networkidle or commit.
waitForSelector - Wait for a selector to become visible before capture.
waitForImages true Wait up to 5 seconds for images after scrolling.
waitForFonts true Wait up to 5 seconds for web fonts.
delay 0 Extra milliseconds after navigation.
scrollToBottom true Scroll through the page to trigger lazy content.
maxScrollSteps 400 Hard scroll-step cap.
scrollStepPx 250 Pixels per scroll step.
delayAfterScrolling 1000 Milliseconds to settle after scrolling.
waitUntilNetworkIdleAfterScroll false Wait for network idle after scrolling.
waitUntilNetworkIdleAfterScrollTimeout 15000 Network-idle timeout in milliseconds.
hideFixedElements false Hide fixed headers, full-screen overlays and chat widgets. Sticky content blocks stay in place.
cookieBannerAction hide hide, accept or off.
selectorsToHide - Extra comma/newline-separated CSS selectors to hide.
pdfPageSize web web, a4, letter, legal, a3, a5 or tabloid.
pdfLandscape false Landscape PDF pages.
pdfPrintBackground true Include CSS backgrounds and colors in the PDF.
pdfFitOnePage false One tall PDF page instead of paginated paper.
pdfMargin none none, narrow, normal or wide.
maxConcurrency 1 URLs captured in parallel, 1-5. Use 1 for long pages at 2048 MB.
maxRetries 1 Retries for transient navigation failures and blocks.
navigationTimeoutSecs 60 Per-URL navigation and selector timeout.
maxPageHeight 0 Clip full-page images at this CSS height; 0 is unlimited. PDFs keep their full document height.
proxyConfiguration - Optional proxy override. The actor starts direct and escalates to an AUTO datacenter proxy only after a real block.

Output

Each dataset record contains:

Field Meaning
startUrl URL you submitted.
url Final URL after redirects.
screenshotUrl Public download link for the file.
screenshotKey Key of the file in the run's key-value store.
format png, jpeg, webp or pdf.
status success for a real stored capture, otherwise error: ....
timestamp ISO-8601 UTC capture time.
pageTitle Page title at capture time.
httpStatus Main document HTTP status.
contentType Main response content type.
blocked / blockReason Whether the page was a block, captcha or login wall, and which kind.
errorType Machine-readable error category.
device, viewportWidth, viewportHeight, deviceScaleFactor, colorScheme Rendering settings used.
fullPage, selector Capture scope.
imageWidth, imageHeight, fileSizeBytes File dimensions and size.
pageHeight, capturedHeight, truncated Page height, captured height and whether a cap clipped it.
pdfPages, pdfPageSize PDF page count and paper size.
durationMs, imagesTotal, imagesFailed, retries Capture evidence. Image counts cover visible images only; hidden tracking pixels are ignored.
warnings Human-readable notes such as failed images or a hit scroll cap.

Blocked pages are not stored as screenshots and do not produce a success record. The record says blocked: true and status: error: blocked (...), so a challenge page cannot be mistaken for page content.

Examples

Mobile screenshot

{
  "urls": [{"url": "https://stripe.com/"}],
  "device": "iphone_15",
  "format": "jpeg",
  "quality": 85
}

Full-page, dark PDF

{
  "urls": [{"url": "https://tailwindcss.com/"}],
  "format": "pdf",
  "colorScheme": "dark",
  "pdfPageSize": "a4",
  "pdfFitOnePage": true,
  "cookieBannerAction": "hide"
}

Capture one section

{
  "urls": [{"url": "https://www.apify.com/"}],
  "selector": "main",
  "fullPage": false,
  "format": "png"
}

What changed in this revamp

  • scrollToBottom now defaults to true so lazy images are actually loaded.
  • hideFixedElements defaults to false: resetting to the top already avoids repeated headers on most pages, and this keeps sticky content cards in the image. Turn it on to remove fixed headers/overlays.
  • cookieBannerAction now defaults to hide.
  • maxConcurrency now defaults to 1 for safe 2048 MB memory use; raise it only when you have memory headroom.
  • The screenshotUrl field now returns a working public link.
  • waitUntil=domcontentloaded is the prefill because networkidle can stall on analytics-heavy pages.
  • Pages that return 403/captcha/login walls are reported as blocked errors, not successes.

You can turn each of these off from the input form.

Limitations

  • Only public, anonymous pages are supported. Login-protected pages are outside this actor's design.
  • Some sites use CAPTCHA or bot defenses that cannot be bypassed. Those URLs are reported as blocked and are not charged as successful captures.
  • Consent banners are handled on a best-effort basis. Hide is more reliable than click-accept; use selectorsToHide for a site-specific banner.
  • Some lazy images never load because of the site's own rules or missing assets. Only visible images are counted in imagesFailed and listed in warnings; hidden tracking pixels and empty placeholders are ignored.
  • Fixed headers are kept by default. Enable hideFixedElements to remove fixed headers, full-screen overlays and chat widgets; sticky content cards are intentionally preserved.
  • Very long or infinite pages are capped by maxScrollSteps and maxPageHeight; the record sets truncated: true when a cap clips the capture.
  • A direct PDF URL is copied when format=pdf; asking for an image of a PDF is reported as an error because Chromium downloads the file instead of rendering it.
  • PDF pagination follows the browser's print layout, which can differ from the screen layout.

FAQ

Do I need a proxy? No. The actor starts with a direct connection and only uses an AUTO datacenter proxy after a real block. If you supply your own proxy, it is used instead.

Can I capture a page that requires a login? No. Authenticated pages are intentionally out of scope.

How do I hide a cookie banner? Leave cookieBannerAction on hide. If a site uses a custom banner, add its selector to selectorsToHide.

Why is a page reported as blocked? The actor saw an HTTP 403/429/451, a CAPTCHA/Cloudflare challenge, or a login wall. The block page is not saved as a normal screenshot.

Why is my image shorter than the page? Check truncated and warnings. maxPageHeight or maxScrollSteps may have capped the capture.

Can I capture multiple URLs? Yes. Each URL produces its own record and file. Keep maxConcurrency at 1 for very long pages at 2048 MB; use a larger memory setting before raising concurrency.

Can I make a single-page PDF? Set format=pdf and pdfFitOnePage=true. For paper output, choose pdfPageSize and pdfMargin.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build ugu5kWKeaoli71PqF. Documentation is regenerated from the default published build; private drafts are not included.