# Screenshot URL API — Full-Page, PDF & Device Screenshots (`qualifyops/url-screenshot-pro`) Actor Turn any URL into a PNG, JPEG or PDF. Full-page capture with lazy-image auto-scroll, cookie-banner dismissal, retina/device sizing, and single-element screenshots. One public image link per URL. Pay only per successful capture — timeouts and errors are free. - **URL**: https://apify.com/qualifyops/url-screenshot-pro.md - **Developed by:** [QualifyOps](https://apify.com/qualifyops) (community) - **Categories:** Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Screenshot URL API — Full-Page, PDF & Device Screenshots Turn any URL into a **PNG, JPEG, or PDF** — reliably. Built to fix the things that break other screenshot tools: cut-off pages, cookie banners covering the content, missing lazy-loaded images, and no PDF option. ### What you get - **One public image link per URL** in the output table — hotlink it, download it, pipe it into your app. - **Full-page capture** that auto-scrolls first, so lazy-loaded images and infinite feeds actually render. - **Cookie / consent banners dismissed automatically** before the shot (the #1 reason screenshots look wrong). - **PNG, JPEG, and PDF** output. - **Device & retina sizing** — set viewport width/height and 1x/2x/3x pixel density (mobile or desktop). - **Single-element screenshots** via a CSS selector (`#hero`, `.pricing-table`). - **Failures are free** — a timeout or dead URL emits an error row and is **never charged**. ### Pricing **Pay per successful screenshot.** You are charged only for images actually captured. Timeouts and errors cost nothing. ### Input | Field | Description | |---|---| | `urls` | One or more page URLs (each → one image/PDF). | | `format` | `png`, `jpeg`, or `pdf`. | | `fullPage` | Capture the whole scrollable page (default on). | | `dismissCookieBanners` | Auto-accept common cookie/consent popups (default on). | | `selector` | Optional CSS selector to shoot one element. | | `viewportWidth` / `viewportHeight` | Browser size — `390` mobile, `1920` desktop. | | `deviceScaleFactor` | `1` normal, `2` retina, `3` for 3x. | | `waitUntil` / `delayMs` | When to capture; extra settle time for animations/fonts. | | `jpegQuality` | 1–100 (JPEG only). | | `timeoutSecs` | Per-URL timeout. | ### Output One dataset row per URL: ```json { "url": "https://stripe.com", "status": "ok", "format": "png", "title": "Stripe | Financial Infrastructure...", "bytes": 842113, "consentDismissed": true, "fileKey": "0001-https-stripe-com.png", "screenshotUrl": "https://api.apify.com/v2/key-value-stores//records/0001-https-stripe-com.png", "capturedAt": "2026-07-07T..." } ```` ### Use it from code or an agent Call it via the Apify API / MCP, pass a list of URLs, read `screenshotUrl` from each output row. Ideal for monitoring, thumbnails, archiving, visual diffs, and agent tools that need to "see" a page. # Actor input Schema ## `urls` (type: `array`): One or more web page URLs. Each produces one image (or PDF) with a public link in the output. ## `format` (type: `string`): png (lossless), jpeg (smaller), or pdf (full document). ## `fullPage` (type: `boolean`): Capture the entire scrollable page (auto-scrolls to trigger lazy-loaded images). Off = just the viewport. ## `dismissCookieBanners` (type: `boolean`): Auto-click common cookie/consent 'Accept' buttons before capture so they don't cover the page. ## `selector` (type: `string`): CSS selector to screenshot a single element instead of the page (e.g. '#hero', '.pricing-table'). ## `viewportWidth` (type: `integer`): Browser width. Use 390 for mobile, 1920 for desktop. ## `viewportHeight` (type: `integer`): Browser height (ignored dimension-wise when Full page is on). ## `deviceScaleFactor` (type: `integer`): 1 = normal, 2 = retina/2x, 3 = 3x. Higher = sharper, larger files. ## `waitUntil` (type: `string`): When to consider the page loaded before capture. ## `delayMs` (type: `integer`): Additional wait after load — useful for animations/fonts settling. ## `jpegQuality` (type: `integer`): 1–100, only used when format is JPEG. ## `timeoutSecs` (type: `integer`): Give up on a URL after this many seconds (emits a free error row). ## Actor input object example ```json { "urls": [ "https://news.ycombinator.com", "https://stripe.com" ], "format": "png", "fullPage": true, "dismissCookieBanners": true, "viewportWidth": 1920, "viewportHeight": 1080, "deviceScaleFactor": 1, "waitUntil": "networkidle", "delayMs": 500, "jpegQuality": 85, "timeoutSecs": 60 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://news.ycombinator.com", "https://stripe.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("qualifyops/url-screenshot-pro").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": [ "https://news.ycombinator.com", "https://stripe.com", ] } # Run the Actor and wait for it to finish run = client.actor("qualifyops/url-screenshot-pro").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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://news.ycombinator.com", "https://stripe.com" ] }' | apify call qualifyops/url-screenshot-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=qualifyops/url-screenshot-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Screenshot URL API — Full-Page, PDF & Device Screenshots", "description": "Turn any URL into a PNG, JPEG or PDF. Full-page capture with lazy-image auto-scroll, cookie-banner dismissal, retina/device sizing, and single-element screenshots. One public image link per URL. Pay only per successful capture — timeouts and errors are free.", "version": "0.1", "x-build-id": "P5LB0RvAKjOOnUfEX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/qualifyops~url-screenshot-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-qualifyops-url-screenshot-pro", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/qualifyops~url-screenshot-pro/runs": { "post": { "operationId": "runs-sync-qualifyops-url-screenshot-pro", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/qualifyops~url-screenshot-pro/run-sync": { "post": { "operationId": "run-sync-qualifyops-url-screenshot-pro", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "urls" ], "properties": { "urls": { "title": "URLs to screenshot", "type": "array", "description": "One or more web page URLs. Each produces one image (or PDF) with a public link in the output.", "items": { "type": "string" } }, "format": { "title": "Output format", "enum": [ "png", "jpeg", "pdf" ], "type": "string", "description": "png (lossless), jpeg (smaller), or pdf (full document).", "default": "png" }, "fullPage": { "title": "Full page", "type": "boolean", "description": "Capture the entire scrollable page (auto-scrolls to trigger lazy-loaded images). Off = just the viewport.", "default": true }, "dismissCookieBanners": { "title": "Dismiss cookie / consent banners", "type": "boolean", "description": "Auto-click common cookie/consent 'Accept' buttons before capture so they don't cover the page.", "default": true }, "selector": { "title": "Element selector (optional)", "type": "string", "description": "CSS selector to screenshot a single element instead of the page (e.g. '#hero', '.pricing-table')." }, "viewportWidth": { "title": "Viewport width (px)", "minimum": 200, "maximum": 3840, "type": "integer", "description": "Browser width. Use 390 for mobile, 1920 for desktop.", "default": 1920 }, "viewportHeight": { "title": "Viewport height (px)", "minimum": 200, "maximum": 4320, "type": "integer", "description": "Browser height (ignored dimension-wise when Full page is on).", "default": 1080 }, "deviceScaleFactor": { "title": "Pixel density (retina)", "minimum": 1, "maximum": 3, "type": "integer", "description": "1 = normal, 2 = retina/2x, 3 = 3x. Higher = sharper, larger files.", "default": 1 }, "waitUntil": { "title": "Wait until", "enum": [ "load", "domcontentloaded", "networkidle", "commit" ], "type": "string", "description": "When to consider the page loaded before capture.", "default": "networkidle" }, "delayMs": { "title": "Extra delay (ms)", "minimum": 0, "maximum": 15000, "type": "integer", "description": "Additional wait after load — useful for animations/fonts settling.", "default": 500 }, "jpegQuality": { "title": "JPEG quality", "minimum": 1, "maximum": 100, "type": "integer", "description": "1–100, only used when format is JPEG.", "default": 85 }, "timeoutSecs": { "title": "Per-URL timeout (seconds)", "minimum": 5, "maximum": 180, "type": "integer", "description": "Give up on a URL after this many seconds (emits a free error row).", "default": 60 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```