How it will work: 3 steps
- Follow us on ApifyThe tool is built and waits in the queue for the Apify Store. Apify is the cloud platform where our tools run.
- Paste your input and press StartNo code needed: you fill in a form (the input). It already has a working example. For example:
https://apify.comin Website URLs. Each start is one run. - Download the resultsWhen the run ends, the results are in a table (the dataset). Open Output, press Export and pick Excel or CSV. JSON and the API are there too.
This tool is an Apify Actor: a small program that runs on Apify. You can also run it on a schedule, for example every Monday. New to it? Read how it works, step by step and the 8 words you need first.
What it does
Screenshot API turns public web page URLs into PNG, JPEG or PDF files, or small thumbnails. Each URL gets one JSON row with a link to the file, its size, the page title and the HTTP status. Cookie banners and ads are hidden for you. No login and no API key for the sites you capture.
- Waits until the page has loaded (
loadby default; you can pickdomcontentloaded,networkidleor a CSS selector). - Closes the cookie consent pop-up with the open-source Autoconsent rules (OneTrust, Cookiebot, Didomi, Sourcepoint and many more). It clicks "reject" when it can and hides what is left.
- Blocks ads and trackers, so heavy pages load faster and the image shows the content.
- Saves the first screen (default), the whole page, a small thumbnail or a PDF.
- Stores the file in the run's Key-value store and writes one Dataset row with the file link.
Good for
- Link previews and thumbnails for your app (
thumbnailWidth: 320gave 320 × 200 PNGs of about 9–34 KB in our tests). - Screenshots inside your own backend: call the API, get
fileUrl, save or show the file. - Visual checks of your pages on desktop and mobile.
- PDF copies of articles, policies or invoices pages.
- Pages for AI agents and vision models to "look at".
Not a good fit
- Pages behind a login. The Actor does not sign in, does not use your cookies and does not solve CAPTCHAs.
- Some sites block cloud browsers (HTTP 401 or 403). You get an image of what the site shows, with a warning.
- Local and private addresses (
localhost,192.168.x.x,10.x.x.xand similar) are blocked. - No video or GIF recording.
- Up to 200 URLs per run; about 80–100 first-screen shots fit in the default 300-second timeout.
Who uses it
App developers
Make link preview images and thumbnails from your own backend.
QA and design teams
Compare how a page looks on desktop and on mobile.
AI builders
Give a vision model a picture of a page to look at.
Price
Prices will be shown after release.
Questions
Can it take screenshots of pages behind a login?
No. It does not sign in or use your cookies. You get what a visitor sees.
Why does my picture show an error page?
Some sites block cloud browsers. You still get an image of what the site showed, plus a warning.
Can I get the whole page, not just the top?
Yes. Pick full page instead of the first screen.
Can I take mobile screenshots?
Yes. Choose a mobile screen size, or set your own width and height.
Is this a screenshot API or a browser tool?
Both. You call it like any API (HTTP request, JSON in, JSON out), and it renders each page in a real Chrome browser on Apify.
Do I pay for failed URLs?
No. Only saved files are charged, plus the small start fee.
How long are the files kept?
As long as your Apify plan keeps run storage. Download or copy the files if you need them longer.
Can I use my apify/screenshot-url input?
Yes. Its fields urls, waitUntil, delay, viewportWidth, scrollToBottom and selectorsToHide are accepted as they are; proxy is accepted but ignored (pages are opened directly). A networkidle2 wait or a delay above 0 adds the extra-wait add-on. Output names differ: use fileUrl (their screenshotUrl) and kvsKey (their screenshotKey).
Details
Step by step on Apify
- Open the Input tab.
- In Website URLs (
urls), keephttps://apify.comor paste your own URLs, one per line. - Click Start.
- Open the Output tab. The Captures view shows a preview of each screenshot. Click the File link to open or download it.
Use cases
| Task | Input | You get | Key fields | Next step |
|---|---|---|---|---|
| Link preview images | thumbnailWidth: 320 | 320 px wide PNG | fileUrl, width, height | Show it next to the link in your app |
| Screenshot API for your backend | urls, default settings | 1280 × 800 PNG | fileUrl, statusCode, title | Save the file to your storage |
| Mobile check | viewport: "mobile" | 780 × 1688 PNG (390 × 844 at 2×) | fileUrl, width | Compare with the desktop shot |
| Full-page archive | fullPage: true | whole-page PNG | fileUrl, pageHeight, truncated | Schedule it every week |
| Page to PDF | format: "pdf" | A4 PDF with text | fileUrl, pdfPages, bytes | Keep with your documents |
| Smaller files | format: "jpeg", jpegQuality: 70 | JPEG | fileUrl, bytes | Reports, e-mails |
Tips for better results
- Use thumbnail mode for previews. Small files load fast in your app.
- Save the file soon after the run. It lives in the run's storage.
- Raise the run timeout for many full-page shots, or split the list.
Limits and good to know
- Up to 200 URLs per run. Split larger lists into several runs
- The default run timeout is 300 seconds. On real sites about 80–100 first-screen shots, or about 40 full pages or PDFs, fit in it. For more, raise the run timeout (for example to 900 s) or split the list. The Actor stops 25 seconds before the timeout and lists the URLs it did not reach
- Each page has its own time limit, so one slow site cannot block the run
- If many pages time out or fail, the run stops early with
TOO_MANY_TIMEOUTSorTOO_MANY_FAILURES, so a list of dead sites does not run for long
For developers
Sample result
One result from a real test run, in JSON. Real values change from run to run. In Excel or CSV each field is a column.
{
"url": "https://apify.com",
"finalUrl": "https://apify.com/",
"status": "success",
"statusCode": 200,
"format": "png",
"fileUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/shot-0001-apify.com.png?signature=<signature>",
"imageUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/shot-0001-apify.com.png?signature=<signature>",
"kvsKey": "shot-0001-apify.com.png",
"contentType": "image/png",
"bytes": 142346,
"width": 1280,
"height": 800,
"pageHeight": null,
"truncated": false,
"pdfPages": null,
"title": "Apify: Marketplace of ready-to-run tools for AI",
"viewport": "desktop",
"viewportWidth": 1280,
"viewportHeight": 800,
"deviceScaleFactor": 1,
"thumbnailWidth": null,
"fullPage": false,
"cookieBanner": { "detected": false, "cmp": null, "handled": false },
"warnings": [],
"loadTimeMs": 1517,
"fetchedAt": "2026-10-15T18:03:39.340Z",
"errorCode": null,
"error": null
}Data fields (28)
| Field | Type | Meaning |
|---|---|---|
url | string | URL as given in the input. |
finalUrl | string | URL after redirects; null when the page did not load. |
status | string | success when a file was saved; failed otherwise (see errorCode). |
statusCode | integer | HTTP status of the main page, e.g. 200 or 404. |
format | string | Output format of this run. |
fileUrl | string | Public link to the saved file (image or PDF) in the run key-value store. |
imageUrl | string | Same as fileUrl for PNG/JPEG (used for the preview column); null for PDF. |
kvsKey | string | Key of the file in the run key-value store, e.g. shot-0001-apify.com.png. |
contentType | string | image/png, image/jpeg or application/pdf. |
bytes | integer | File size in bytes. |
width | integer | Image width in pixels (CSS width × pixel density); null for PDF. |
height | integer | Image height in pixels; null for PDF. |
pageHeight | integer | Full scrollable page height in CSS pixels at capture time. Null for viewport-only image shots, where it is not measured to save time. |
truncated | boolean | True when a very long page was cut at the maximum height. |
pdfPages | integer | Number of PDF pages; null for images. |
title | string | Page <title>. |
viewport | string | Device preset: desktop, full-hd, tablet, mobile or custom. |
viewportWidth | integer | Viewport width in CSS pixels. |
viewportHeight | integer | Viewport height in CSS pixels. |
deviceScaleFactor | number | Pixel density used: 1 or 2 usually, fractional (e.g. 0.25) for thumbnails. |
thumbnailWidth | integer | Requested thumbnail width in pixels; null for a full-size image. |
fullPage | boolean | True for a full-page image. |
cookieBanner | object | Cookie consent handling: detected (pop-up shown), cmp (consent manager name), handled (rejected/closed). Null when hiding is off or the page failed. |
warnings | array | Non-fatal notes, e.g. the page was cut or a load event was late. |
loadTimeMs | integer | Time from navigation start to capture, in milliseconds. |
fetchedAt | string | Capture time (ISO 8601, UTC). |
errorCode | string | INVALID_URL, BLOCKED_URL, DNS_ERROR, CONNECTION_FAILED, NAVIGATION_TIMEOUT, SELECTOR_NOT_FOUND, NOT_A_WEB_PAGE, CAPTURE_FAILED or OUTPUT_TOO_LARGE; null on success. |
error | string | Plain-English error message; null on success. |
Input settings (22)
The main fields of the input form. With the API you send them as JSON.
| Setting | Name in the API | Type | Example value |
|---|---|---|---|
| Website URLs required | urls | array | ["https://apify.com"] |
| Output format | format | string | "png" |
| Full page | fullPage | boolean | false |
| Device / viewport | viewport | string | "desktop" |
| Custom width (px) | viewportWidth | integer | 1280 |
| Custom height (px) | viewportHeight | integer | 800 |
| Pixel density | deviceScaleFactor | integer | |
| Thumbnail width (px) | thumbnailWidth | integer | |
| Wait until | waitFor | string | "load" |
| Element to wait for (CSS selector) | waitForSelector | string | |
| Extra delay (ms) | delayMs | integer | 0 |
| Page load timeout (s) | navigationTimeoutSecs | integer | |
| Scroll to load lazy images | scrollToLoadLazyContent | boolean | true |
| Hide cookie banners | hideCookieBanners | boolean | true |
| Block ads and trackers | blockAds | boolean | true |
| Hide elements (CSS selectors) | hideSelectors | array | |
| Max full-page height (px) | maxFullPageHeight | integer | 15000 |
| JPEG quality | jpegQuality | integer | 80 |
| PDF paper size | pdfFormat | string | "A4" |
| PDF landscape | pdfLandscape | boolean | false |
| PDF background graphics | pdfPrintBackground | boolean | true |
| PDF looks like the screen | pdfUseScreenMedia | boolean | false |