You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: "Announcing Screenshots API: Generate pixel-perfect webpage screenshots on demand"
4
+
description: Appwrite's new Screenshots API lets you generate screenshots of any public webpage with a single API call. Control browser environment, device settings, locale, and more without needing to configure your own headless browser infrastructure.
Capturing consistent, high-quality screenshots of web pages is harder than it should be.
15
+
16
+
What starts as a simple requirement, “render this page as an image,” quickly turns into a fragile setup of headless browsers, custom scripts, and environment-specific workarounds. Fonts render differently across machines. Animations race your screenshot timer. Cookie banners and permission prompts block content. Pages behave one way locally and another in CI. Keeping screenshots reliable across devices, locales, and time zones often means babysitting a complex Playwright or Puppeteer pipeline that breaks the moment a browser update lands.
17
+
18
+
Most teams do not want to run their own headless browser infrastructure. They just want the result.
19
+
20
+
Today, we are excited to announce the **Screenshots API**, a new addition to **Appwrite Avatars**, that lets you generate fully customizable webpage screenshots with a single API call, without maintaining any headless browser infrastructure.
21
+
22
+
# Capture webpages exactly as users see them
23
+
24
+
The Screenshots API allows you to capture screenshots of any public webpage while controlling the browser environment in which it is rendered.
25
+
26
+
With one request, you can customize:
27
+
28
+
- Browser viewport size and device scale
29
+
- Light or dark theme rendering
30
+
- Full-page or viewport-only screenshots
31
+
- Custom headers, user agents and locales
32
+
- Timezone and geolocation simulation
33
+
- Touch support and browser permissions
34
+
- Output format, dimensions, and quality
35
+
36
+
This means your screenshots are no longer best guesses. They are accurate representations of real user experiences.
37
+
38
+
# Built for real-world developer workflows
39
+
40
+
Screenshots are not just images. They are an essential building block for modern developer workflows.
41
+
42
+
The Screenshots API is designed for use cases like:
43
+
44
+
- Generating visual documentation automatically
45
+
- Creating rich link previews for apps and dashboards
46
+
- Running QA checks across devices and browsers
47
+
- Validating responsive and localized layouts
48
+
- Archiving web pages for compliance and records
49
+
- Powering automated reports and visual dashboards
50
+
51
+
Instead of maintaining your own headless browser infrastructure, you can rely on a managed, consistent API that scales with your application.
52
+
53
+
# Simple API, powerful customization
54
+
55
+
Getting started with the Screenshots API is as simple as providing a URL.
From there, you can dial in exactly how the page should be rendered.
74
+
75
+
Capture mobile, tablet, or desktop views. Enable full-page scrolling. Render pages in dark mode. Simulate a specific country, language, or timezone. Even pre-grant browser permissions to avoid blocked or degraded states.
76
+
77
+
# Simulate browsers, devices, and locations
78
+
79
+
Modern web apps behave differently depending on where and how they are accessed. The Screenshots API lets you reflect that reality.
80
+
81
+
You can:
82
+
83
+
- Test responsive layouts across viewport sizes
84
+
- Verify localized content using different locales and timezones
85
+
- Capture region-specific content with geolocation simulation
86
+
- Render pages as touch devices or desktop browsers
87
+
- Validate pages that depend on browser permissions
88
+
89
+
This makes it easier to test, document, and ship with confidence.
90
+
91
+
# Part of Appwrite Avatars
92
+
93
+
The Screenshots API lives alongside other Avatars endpoints, making it easy to integrate into existing Appwrite projects. Whether you are generating previews, reports, or automated documentation, screenshots become just another API resource you can depend on.
94
+
95
+
# Available now
96
+
97
+
The Screenshots API is available today as part of Appwrite Avatars. You can start generating screenshots immediately using the Appwrite SDKs and REST API.
98
+
99
+
This API is already being used in production by [Imagine](https://imagine.dev) to generate real-time preview screenshots for projects built on the platform, validating it against real user traffic.
100
+
101
+
To get started, head over to the [documentation](/docs/products/avatars/screenshots) and try it out in your next project.
102
+
103
+
As always, we would love to see what you build with it.
0 commit comments