---
title: Capture Webpage Screenshots in Bulk API
slug: capture-webpage-screenshots-bulk
url: https://apyhub.com/martin10291/service/capture-webpage-screenshots-bulk
provider: Martin Petrov
categories: [Media Kit]
tags: [website-screenshot, bulk-screenshots, webpage-to-image, url-to-png, full-page-capture, web-capture]
auth: api_key
version: 1.0
service_type: sync
endpoints: 1
atoms: 100
mcp: true
---

# Capture Webpage Screenshots in Bulk API

Capture public webpages as PNG, JPEG, or PDF, up to 100 per call, with device presets and full-page capture. Useful for archiving, visual QA, and previews.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/martin10291/capture-webpage-screenshots-bulk/website-screenshot-api` | What it does Captures one or more public webpages in a real Chromium browser as PNG, JPEG or PDF fi… | 100 |

## Endpoint reference

### Website Screenshot API - Webpage to Image, URL to PNG

`POST https://api.eu.apyhub.com/martin10291/capture-webpage-screenshots-bulk/website-screenshot-api` · 100 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `urls` | body | array of string | yes | Public pages to capture, one URL per entry. Full http/https URLs or bare domains. Private and local addresses are rejected; duplicates are captured once. Example: `["https://example.com","https://www… |
| `device` | body | string | no | Viewport preset: desktop 1366x768, desktop-hd 1920x1080, laptop 1280x800, tablet 820x1180 (2x), mobile 390x844 (3x). One of: desktop, desktop-hd, laptop, tablet, mobile. Default: `desktop`. Example:… |
| `format` | body | string | no | Output file format. One of: png, jpeg, pdf. Default: `png`. Example: `png`. |
| `delayMs` | body | integer | no | Extra wait after loading, before the capture, in milliseconds. Example: `0`. |
| `maxUrls` | body | integer | no | Hard cap on how many URLs are captured in this call. Example: `100`. |
| `darkMode` | body | boolean | no | Ask the page for its dark color scheme (prefers-color-scheme: dark). Example: `false`. |
| `fullPage` | body | boolean | no | Capture the whole scrollable page up to maxHeight; false captures only the viewport. Default: `true`. Example: `true`. |
| `maxHeight` | body | integer | no | Full-page captures are cut at this height in pixels. Example: `10000`. |
| `waitUntil` | body | string | no | When the page counts as loaded. One of: load, domcontentloaded, networkidle. Default: `load`. Example: `load`. |
| `jpegQuality` | body | integer | no | JPEG quality, only used when format is jpeg. Example: `80`. |
| `timeoutSecs` | body | integer | no | Give up on a page that does not load in this many seconds; a partly loaded page is still captured with a warning. Example: `30`. |
| `hideSelectors` | body | array of string | no | CSS selectors to hide before the capture. Example: `[".chat-widget","#sticky-header"]`. |
| `includeFailed` | body | boolean | no | Also return a free row with an error message for each page that failed. Default: `false`. Example: `false`. |
| `viewportWidth` | body | integer | no | Overrides the preset width (320-3840); 0 uses the preset. Example: `0`. |
| `viewportHeight` | body | integer | no | Overrides the preset height (240-2160); 0 uses the preset. Example: `0`. |
| `elementSelector` | body | string | no | CSS selector of one element to capture instead of the page (first match, PNG and JPEG). 400 if nothing matches. Example: `header`. |
| `waitForSelector` | body | string | no | CSS selector to wait for before the capture. Example: `#main`. |
| `hideCookieBanners` | body | boolean | no | Hide common cookie and consent popups with CSS; nothing is clicked. Example: `true`. |
| `scrollToLoadImages` | body | boolean | no | For full-page captures, scroll through the page first so lazy-loaded images appear. Example: `true`. |

#### Quickstart

Capture one page as a full-page PNG with the default desktop viewport.

```bash
curl -X POST "https://api.eu.apyhub.com/martin10291/capture-webpage-screenshots-bulk" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://apyhub.com"], "format": "png"}'
```

#### What you'll get back

Returns a JSON object with `count`, `billed` and an `items` array. Each item is one captured page with its `screenshotUrl` download link, size and page details.

```json
{
  "billed": 1,
  "count": 1,
  "items": [
    {
      "url": "https://example.com",
      "finalUrl": "https://example.com/",
      "statusCode": 200,
      "title": "Example Domain",
      "device": "desktop",
      "deviceScaleFactor": 1,
      "format": "png",
      "fullPage": true,
      "width": 1366,
      "height": 787,
      "pageHeight": 787,
      "truncated": false,
      "bytes": 72342,
      "key": "shot-example.com-327c3fda87.png",
      "screenshotUrl": "https://radarbg.com/m/f/k1jn1VL26vBRNLo2e/shot-example.com-327c3fda87.png?s=3kvS8fVIQ43HitqOrL5D",
      "sha256": "582c8efb49c61cbee5fc044d22ce5b843133dc6cefddb89ad10cef3d5d34ef76",
      "contentHash": "43338e32beb5871d10be1ac1",
      "loadTimeMs": 959,
      "takenAt": "2026-11-17T10:19:57Z",
      "error": null,
      "warning": null
    }
  ]
}
```

## About

## What it does
The Capture Webpage Screenshots in Bulk API renders public webpages in a real Chromium browser and saves each one as a PNG, JPEG or PDF. Send up to 100 URLs in `urls` and get back `count`, `billed` and an `items` array with one row per page: a `screenshotUrl` download link, the image `width` and `height`, the page `title`, `statusCode` and `finalUrl`, and file details such as `bytes` and `sha256`.

Pick a viewport with `device` (`desktop`, `desktop-hd`, `laptop`, `tablet` or `mobile`), or set your own size with `viewportWidth` and `viewportHeight`. `fullPage` captures the whole scrollable page, up to `maxHeight` (500 to 30,000 px), and `truncated` tells you when a page was cut. Use `waitUntil`, `delayMs` and `waitForSelector` to wait for late content, `hideSelectors` and `hideCookieBanners` to hide overlays, `darkMode` for the dark color scheme, and `elementSelector` to capture one element.

Use it to archive pages, take visual QA and monitoring snapshots, or make preview images. Only successful captures are billed. Pages that fail (missing domain, HTTP error, private address) are left out, unless `includeFailed` is on, in which case they come back as free rows with an `error` message. If no URL can be captured, the call returns a 400 instead.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/martin10291/service/capture-webpage-screenshots-bulk
