Total: $49
"], "viewports": ["desktop"], "savePdf": true } ``` The row's `url` is `html:0` for the first document, and `source` is `html`. #### Local language, time zone and country Many sites change language, date format or opening hours by visitor. Set all three to see the page as a local visitor sees it: ```json { "urls": ["https://example.com"], "locale": "de-DE", "timezoneId": "Europe/Berlin", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "DE" } } ``` ### Fields | Field | Meaning | |---|---| | `status` | `captured`, `skipped` (robots.txt or a bot check) or `failed` (load error or HTTP error) | | `type`, `format` | `screenshot` or `pdf`; `png`, `jpeg`, `webp` or `pdf` | | `viewport`, `viewportWidth`, `viewportHeight` | Screen size used | | `fileUrl`, `fileKey`, `fileSizeBytes` | The saved file | | `imageWidth`, `imageHeight`, `pageHeight`, `truncated` | Image and page size | | `finalUrl`, `pageTitle`, `httpStatus` | Page details after redirects | | `changed`, `diffPercent`, `diffImageUrl`, `previousCapturedAt` | Change detection results. Null on the first run | | `captureSelector`, `elementFound` | The element captured, and whether it was found. Null when you capture the whole page | | `waitSelectorFound` | Whether the wait-for element appeared. Null when you set no wait selector | | `scale`, `colorScheme` | Pixel density (1, 2 or 3; null for PDFs) and light or dark mode | | `adsBlocked` | Ad and tracker requests blocked on the page. Null when ad blocking is off | | `proxyCountry` | Proxy country used, `any` for Apify Proxy without a country, `custom` for your own proxy URLs. Null without a proxy | | `maskedCount` | Page elements covered by a grey box (Mask elements). 0 when none | | `locale`, `timezoneId` | Browser language and time zone used. Null when not set | | `source` | `url` for a web page, `html` for an HTML document from the input | ### How change detection works The Actor keeps the last screenshot of each URL and viewport in a named key-value store. The store is called `website-screenshot-pdf-state`, and the screenshots are kept under your state key. On the next run it compares the new screenshot with the stored one, pixel by pixel. A pixel counts as changed when a colour channel moves by more than 24 of 255. This ignores tiny rendering noise. A page that got taller or shorter counts the extra area as changed. Then the new screenshot becomes the baseline for the next run. Use one state key per watch list. Pages with rotating banners, live counters or ads will show small changes on every run. Turn on "Block ads and trackers", or cover moving parts with "Mask elements". A masked part becomes a grey box in every capture, so it never counts as a change, and the layout below it does not move. "Hide elements" removes an element instead, which can shift the page. A capture at another scale, in dark mode, or with another locale or time zone keeps its own baseline. ### Pricing You pay per event: - $0.005 when the run starts, for each GB of memory (one event at the default 1 GB). - $0.004 per capture (one screenshot or one PDF), which is $4 per 1,000 captures. On the Gold, Platinum and Diamond plans it is $0.0032, which is $3.20 per 1,000. Change detection and diff images are included. - Skipped and failed URLs are free. - $0.05 per capture through a proxy (optional), on top of the capture price, which is $50 per 1,000. Proxy traffic has its own cost. Captures without a proxy never pay it. Example: 50 URLs at desktop and phone size make 100 captures. That run costs $0.405 ($0.005 + 100 x $0.004), or $0.325 on Gold. The same run through a proxy costs $5.405. ### FAQ **How do I stop false change alerts?** Add the moving parts to **Mask elements**, for example `["time", ".ticker", "#last-updated"]`. Turn on **Block ads and trackers** for pages with ads. **Why was a page skipped?** Its robots.txt disallows it, or it showed a bot check. Skipped and failed pages are free and listed with a reason. **How long can a full page be?** Up to **Maximum page height** (8,000 pixels by default, 16,000 at most). Longer pages are cut and marked `truncated: true`. **Can it log in to a page?** No. It captures public pages only. **Why does a page look different from my browser?** Cookie banners are hidden by default. Language, time zone and country can differ: set **Locale**, **Time zone** and a proxy country. **How do I get change alerts by email or Slack?** Schedule the Actor with change detection on. Then add an Apify integration (email, Slack or a webhook) and use the "Changed pages" view. **Does masking hide personal data?** Yes. A masked element is a solid box in the file. ### Use it from the API or an AI agent One call runs the Actor and returns the rows, each with a `fileUrl` you can open without a token: ```bash curl -X POST "https://api.apify.com/v2/acts/maliksaid~website-screenshot-pdf/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"urls": ["https://example.com"], "viewports": ["desktop"]}' ``` AI agents can call it through the Apify MCP server (mcp.apify.com) by its name, `maliksaid/website-screenshot-pdf`. ### Good to know - The Actor reads each site's robots.txt first and skips pages it disallows. This cannot be turned off. - It uses a normal headless Chromium browser. It does not solve CAPTCHAs, log in or hide that it is a browser. Sites that show a bot check or answer 403 are listed as skipped or failed, at no charge. - Phone and tablet captures use the screen width, so pages show their responsive layout. The browser does not pretend to be a phone. - Only capture pages you are allowed to copy. Some sites' terms limit how you may reuse their content. - Default memory is 1 GB. For long lists, 2 GB runs more pages at once. # Actor input Schema ## `urls` (type: `array`): Web pages to capture, one per line. A URL without https:// gets it added. Pages that robots.txt disallows are skipped and listed with a reason. ## `htmlDocuments` (type: `array`): Optional. Raw HTML to capture as an image or PDF, one document per entry, up to 2 MB each and 5 MB in total per run. Use it for invoices, reports or social cards that have no public URL. To capture only HTML, clear the URLs list. Remote images and fonts load as usual, and each remote host's robots.txt applies. Local files never load. ## `viewports` (type: `array`): Screen sizes to capture each URL at. Use desktop (1440x900), laptop (1280x800), tablet (768x1024), phone (390x844) or a size such as 1920x1080. Each URL and viewport pair is one capture. ## `fullPage` (type: `boolean`): On: capture the whole scrolling page. Off: capture only the visible viewport (above the fold). ## `format` (type: `string`): File type of each screenshot. PNG is lossless. JPEG and WebP files are smaller. ## `quality` (type: `integer`): Image quality from 1 to 100 for JPEG and WebP. PNG ignores it. ## `scale` (type: `integer`): 1 is a normal screen. 2 gives sharp images like a retina screen, and 3 like a high-end phone. Files are larger. To keep memory safe, a full page at 2 or 3 stops at the same pixel count as a default desktop capture: about 2,000 page pixels tall for desktop at 2, and about 3,280 for a phone at 3. The row then says truncated: true. ## `colorScheme` (type: `string`): Show the page in light or dark mode. Sites that support dark mode switch to their dark theme. ## `locale` (type: `string`): Optional browser language and region, such as de-DE, fr-FR or ar-SA. It also sets the Accept-Language header. Combine it with a proxy country to see a page as local visitors see it. ## `timezoneId` (type: `string`): Optional browser time zone, such as Europe/Berlin or Asia/Riyadh. Pages that show local times or opening hours use it. ## `savePdf` (type: `boolean`): Save one PDF of each URL as well, printed with backgrounds. Each PDF counts as one capture. ## `pdfFormat` (type: `string`): Paper size of the PDF. ## `pdfLandscape` (type: `boolean`): Print the PDF in landscape orientation. ## `hideCookieBanners` (type: `boolean`): Hide common cookie consent banners (OneTrust, Cookiebot, Usercentrics, Didomi, CookieYes and others) with CSS before the capture. Nothing is clicked or accepted. ## `hideSelectors` (type: `array`): CSS selectors of elements to hide before the capture, for example chat widgets or ads. Example: #intercom-container ## `maskSelectors` (type: `array`): CSS selectors of moving parts to cover with a grey box, such as a clock, a rotating banner or a price ticker. The layout stays the same, so masked parts never count as a change. Masking also hides personal data in a capture. ## `blockAds` (type: `boolean`): Block requests to common ad and tracker hosts of other sites before the page loads. Pages load faster, and change detection reports fewer false changes from rotating ads. ## `captureSelector` (type: `string`): Capture only the first element that matches this CSS selector, for example #pricing. Empty: capture the page. PDFs ignore it. ## `waitForSelector` (type: `string`): Wait up to 15 seconds for this element to appear before the capture. If it never appears, the capture goes ahead and the row says so. ## `waitSecs` (type: `integer`): Wait this long after the page loads and before the capture, for animations and late content. ## `scrollToLoad` (type: `boolean`): For full-page captures, scroll down the page first so lazy-loaded images appear. ## `maxPageHeight` (type: `integer`): Full-page captures stop at this height. Very long pages are cut, and the row says truncated: true. ## `compareWithPrevious` (type: `boolean`): Compare each screenshot with the one from the last run that used the same state key. Each row gets changed, diffPercent and, for changed pages, a diff image with changed pixels in red. Schedule the Actor with this on to watch pages for visual changes. ## `stateKey` (type: `string`): Name of the stored baseline screenshots. Use a different key for each separate watch list. ## `changeThreshold` (type: `number`): A page counts as changed when more than this share of pixels differs, in percent. Example: 0.1 means 1 pixel in 1,000. ## `maxCaptures` (type: `integer`): Stop after this many files (screenshots plus PDFs). The default keeps test runs short. Set 0 for no limit. ## `proxyConfiguration` (type: `object`): Optional. Use Apify Proxy and pick a country to see the page as visitors in that country see it, for example local prices, language or region banners. Each capture made through a proxy adds the "Proxy capture" charge on top of the normal capture price. Off by default. The proxy is for country choice only: a page with a bot check is still skipped. ## Actor input object example ```json { "urls": [ "https://crawlee.dev", "https://books.toscrape.com" ], "htmlDocuments": [], "viewports": [ "desktop", "phone" ], "fullPage": true, "format": "png", "quality": 80, "scale": 1, "colorScheme": "light", "savePdf": false, "pdfFormat": "A4", "pdfLandscape": false, "hideCookieBanners": true, "hideSelectors": [], "maskSelectors": [], "blockAds": false, "captureSelector": "", "waitForSelector": "", "waitSecs": 1, "scrollToLoad": true, "maxPageHeight": 8000, "compareWithPrevious": false, "stateKey": "default", "changeThreshold": 0.1, "maxCaptures": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description ## `files` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '