# Website Screenshot API: Bulk Full Page PNG and JPEG (`pistachio_implementation/website-screenshot-api`) Actor

Take full page screenshots of a list of URLs in one run. PNG or JPEG, desktop, laptop, tablet or mobile, dark mode, cookie banners hidden, lazy images loaded. Each screenshot gets a download link, status code and page title. Pay per screenshot.

- **URL**: https://apify.com/pistachio\_implementation/website-screenshot-api.md
- **Developed by:** [Hay Equipos](https://apify.com/pistachio_implementation) (community)
- **Categories:** Developer tools, Automation, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 screenshot saveds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Website Screenshot API: bulk full page PNG and JPEG

Paste a list of URLs and get a screenshot of each page, with a direct download link, the page title, the HTTP status and the image size. Full page or first screen, PNG or JPEG, desktop, laptop, tablet or mobile, light or dark mode. Cookie banners are hidden and lazy loaded images are scrolled into view before capture, so the images look like what a visitor sees.

It runs a real headless Chrome browser, captures pages in parallel, retries a page once if it times out or crashes the browser, and starts a fresh browser when needed. You pay per screenshot that succeeds, with a fixed price you can see before you run it.

### Who uses it

- **Marketers and agencies** archiving landing pages, competitor pages and ad destinations.
- **SEO and QA teams** checking how pages render on mobile and desktop after a release.
- **Compliance and legal teams** keeping dated visual records of public pages.
- **Developers and AI agents** that need an image of a page for a report, a thumbnail or a vision model.

### Input

| Field | What it does |
|---|---|
| `urls` | Pages to capture, one per line |
| `device` | `desktop` (1280 by 800), `laptop` (1440 by 900), `tablet` (820 by 1180 at 2x), `mobile` (390 by 844 at 3x) |
| `viewportWidth`, `viewportHeight` | Custom size in CSS pixels, overrides the preset |
| `fullPage` | Whole page (default) or only the first screen |
| `maxPageHeight` | Very long pages are cut at this height (default 10,000 pixels) |
| `format`, `jpegQuality` | PNG, or JPEG with a quality from 1 to 100 |
| `waitUntil`, `delayMs` | When to capture: DOM ready, load event or network idle, plus an extra wait |
| `scrollToBottom` | Scroll first so lazy images load |
| `hideCookieBanners` | Hide common consent popups without clicking them |
| `hideSelectors` | Your own CSS selectors to hide, for example a chat widget |
| `darkMode` | Ask the page for its dark theme |
| `timeoutSecs`, `maxConcurrency`, `maxUrls` | Speed and safety limits |

#### Example input

```json
{
    "urls": ["https://apify.com", "https://en.wikipedia.org/wiki/Web_scraping"],
    "device": "desktop",
    "fullPage": true,
    "format": "jpeg",
    "jpegQuality": 80,
    "hideCookieBanners": true
}
```

### Output

Each image is saved in the run's key value store. `screenshotUrl` is a signed link that opens the image directly, with no API token needed, so you can paste it into a sheet, a report or another tool. The dataset has one row per URL:

```json
{
    "url": "https://apify.com/",
    "finalUrl": "https://apify.com/",
    "statusCode": 200,
    "title": "Apify: Marketplace of ready-to-run tools for AI",
    "screenshotUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/screenshot_0001_apify_com_.jpg?signature=<signature>",
    "screenshotKey": "screenshot_0001_apify_com_.jpg",
    "format": "jpeg",
    "device": "desktop",
    "viewportWidth": 1280,
    "viewportHeight": 800,
    "fullPage": true,
    "imageWidth": 1280,
    "imageHeight": 4000,
    "truncated": true,
    "bytes": 363614,
    "loadTimeMs": 7636,
    "takenAt": "2026-09-27T06:17:50.332Z",
    "error": null
}
```

Pages that fail (DNS error, timeout after one retry) still get a row with the `error` field filled, so you know which ones to retry.

### Pricing

Pay per event, no subscription and no platform usage charges on top:

- **$3.00 per 1,000 screenshots** ($0.003 each).
- Failed pages are free.

### Limits

- Pages behind a login cannot be captured, and the actor never logs in.
- Sites with strong bot protection may show their challenge page instead of the content; you then get a screenshot of the challenge. The status code and title help you spot these.
- Cookie banner hiding covers the most common consent tools but not every custom popup; add selectors in `hideSelectors` for the rest.
- Pages longer than `maxPageHeight` are cut and marked `truncated`. Images are also kept under about 16,000 pixels tall, so on the mobile preset (3x) a full page capture stops at about 5,300 CSS pixels.
- Screenshots stay in the run's storage for the retention period of your Apify plan; download them if you need them longer.

### FAQ

**How fast is it?** Two pages at once by default. Light pages take 2 to 5 seconds, heavy full page captures 20 to 40 seconds, so plan on 5 to 15 pages a minute at the default 1 GB of memory. More memory with a higher `maxConcurrency` is faster.

**Can I get PDF output?** Not in this version. PNG and JPEG only.

**Can I capture only part of a page?** Use `fullPage: false` for the first screen, or set a custom viewport.

**Why is the image height larger than the viewport height times the scale?** For full page captures the height is the full scrollable height of the page, up to `maxPageHeight`.

**Can AI agents call it?** Yes. The input is small and the price per screenshot is fixed, so it works well through the Apify MCP server.

# Actor input Schema

## `urls` (type: `array`):

One page per line, for example https://apify.com. A missing https:// is added.

## `device` (type: `string`):

Screen size preset. Desktop 1280 by 800, laptop 1440 by 900, tablet 820 by 1180 (2x), mobile 390 by 844 (3x, iPhone user agent).

## `viewportWidth` (type: `integer`):

Overrides the preset width in CSS pixels. 0 keeps the preset.

## `viewportHeight` (type: `integer`):

Overrides the preset height in CSS pixels. 0 keeps the preset.

## `fullPage` (type: `boolean`):

Capture the whole scrollable page instead of only the first screen.

## `maxPageHeight` (type: `integer`):

Very long pages are cut at this height in CSS pixels, and the row is marked truncated.

## `format` (type: `string`):

PNG is lossless; JPEG files are much smaller.

## `jpegQuality` (type: `integer`):

Used only for JPEG, from 1 to 100.

## `waitUntil` (type: `string`):

When the page counts as loaded. Network idle waits longest and suits heavy single page apps.

## `delayMs` (type: `integer`):

Time for animations and late content after the page loads.

## `scrollToBottom` (type: `boolean`):

Scrolls through the page before a full page capture so lazy loaded images appear.

## `hideCookieBanners` (type: `boolean`):

Hides common consent popups (OneTrust, Cookiebot, Usercentrics, Didomi, Quantcast and others) without clicking anything.

## `hideSelectors` (type: `array`):

CSS selectors to hide before capture, for example .popup or #newsletter.

## `darkMode` (type: `boolean`):

Asks the page for its dark color scheme, when it has one.

## `timeoutSecs` (type: `integer`):

A page that does not load in this time is retried once, then reported as failed.

## `maxConcurrency` (type: `integer`):

How many pages are captured in parallel. More is faster but needs more memory; above 2, raise the run memory to 2 GB or more.

## `maxUrls` (type: `integer`):

Only the first N URLs are captured.

## Actor input object example

```json
{
  "urls": [
    "https://apify.com"
  ],
  "device": "desktop",
  "viewportWidth": 0,
  "viewportHeight": 0,
  "fullPage": true,
  "maxPageHeight": 10000,
  "format": "png",
  "jpegQuality": 80,
  "waitUntil": "load",
  "delayMs": 1000,
  "scrollToBottom": true,
  "hideCookieBanners": true,
  "hideSelectors": [],
  "darkMode": false,
  "timeoutSecs": 45,
  "maxConcurrency": 2,
  "maxUrls": 1000
}
```

# Actor output Schema

## `results` (type: `string`):

All rows the run saved to the default dataset.

## `screenshots` (type: `string`):

Screenshot image files (PNG or JPEG) saved in the run's key value store.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://apify.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pistachio_implementation/website-screenshot-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": ["https://apify.com"] }

# Run the Actor and wait for it to finish
run = client.actor("pistachio_implementation/website-screenshot-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://apify.com"
  ]
}' |
apify call pistachio_implementation/website-screenshot-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pistachio_implementation/website-screenshot-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/s7gmPZjUfh5l27yFb/builds/AeBo0JBHzK2BfsUGP/openapi.json