Ultimate Webpage Screenshot Actor

⚡ Capture full-page or viewport screenshots of any webpage.
Optimized for SEO tools, automation pipelines, and app integrations.

The Ultimate Webpage Screenshot is an Apify-based automation tool designed to generate high-quality screenshots of webpages.

Whether you're performing SEO audits, archiving web content, or integrating screenshot functionality into your apps, this actor provides a seamless way to capture full-page screenshots or viewport images.

---

⚙️ Key Features

• High-Quality Screenshots: Capture full-page or viewport-only screenshots in PNG format.
• Browser Emulation: Use presets for desktop (1920×1080), mobile (390×844), or tablet (1024×1366) or set custom screen sizes.
• Language & User-Agent Control: Customize accept-language and User-Agent for regional or device-specific rendering.
• Cookie Popup Handling: Automatically disable cookie banners for cleaner captures.
• Apify Integration: Seamlessly connects with other Apify actors, datasets, and workflows.
• Error Handling: Detects invalid URLs, API issues, or timeouts and provides detailed error messages.
• SEO Optimization: Perfect for SEO audits; can simulate Googlebot views or localized rendering.

---

🔄 How It Works

1. Input Submission: Provide a target URL and optional parameters via the Apify input schema.
2. Screenshot Generation: The service renders the page using your selected options (preset or custom view).
3. Storage: The actor downloads the image, stores it in Apify’s Key-Value Store, and generates a public URL.
4. Output: Returns structured JSON with URL, screenshot URL, status, and timestamp.

This process ensures fast, reliable, and secure screenshot generation. Ideal for automation pipelines and SEO workflows.

---

🧩 Input Parameters

The actor accepts JSON input. Only url is required; other fields are optional.

Parameter	Type	Description	Default
url	string (required)	The webpage to capture (e.g. "https://example.com")	—
accept_language	string	Language header for localized content (e.g. "en-US")	"en-US"
custom_user_agent	string	Custom User-Agent string	—
browser_preset	string	"desktop", "mobile", or "tablet" preset	—
browser_screen_width	integer	Custom width (240–9999 px)	—
browser_screen_height	integer	Custom height (240–9999 px)	—
browser_screen_scale_factor	number	Scale factor (0.5–3)	—
full_page_screenshot	boolean	Capture full page or viewport only	true
disable_cookie_popup	boolean	Disable cookie popups	false

🧠 Example Input

{
  "url": "https://example.com",
  "browser_preset": "desktop",
  "full_page_screenshot": true,
  "disable_cookie_popup": true
}

---

🧾 Output Format

The actor pushes results to an Apify dataset and sets the run output. The structure is consistent for both successful and failed runs:

Field	Type	Description
url	string	The input URL.
screenshotUrl	string	Public Apify URL to the stored screenshot (empty on error).
status	string	"success" or "error".
errorMessage	string	Details for failed runs (empty on success).
timestamp	string	ISO timestamp of the run.

✅ Example Success Output

[
  {
    "url": "https://example.com",
    "screenshotUrl": "https://api.apify.com/v2/key-value-stores/.../screenshot-123456789.png",
    "status": "success",
    "errorMessage": "",
    "timestamp": "2025-10-22T10:30:00.000Z"
  }
]

❌ Example Error Output

[
  {
    "url": "https://invalid.com",
    "screenshotUrl": "",
    "status": "error",
    "errorMessage": "Task error: Invalid URL or 404.",
    "timestamp": "2025-10-22T10:31:00.000Z"
  }
]

---

💡 Example Use Cases

• SEO Analysis: Generate visual reports of website pages during audits.
• Mobile Testing: Preview mobile rendering using the "mobile" preset.
• Automation Pipelines: Chain this actor with crawlers or data extractors.
• Error Debugging: Capture screenshots of failed or unreachable URLs for review.

---

🧰 Tech Stack

• Language: Node.js
• Libraries: Apify SDK, Axios
• Storage: Apify Key-Value Store
• Integration: Fully compatible with Apify Workflows & Datasets

---

🧠 Author Notes

Designed with developers, SEOs, and automation engineers in mind. Fully scalable, robust, and easy to integrate into your Apify ecosystem.

---

Discoverability Keywords: webpage screenshot API, full page screenshot tool, Apify screenshot actor, website screenshot automation, browser screenshot capture, SEO screenshot generator, mobile webpage screenshot