Animated Screenshots
The screencast endpoint lets you generate short video captures of your webpage — either as a static animation (video) or a dynamic scroll-through (scroll). It’s great for showcasing your app, previewing a website, or generating media content programmatically.
Plan Availability
Available on Growth and Scale plans. Also available in test mode with the Free plan.
Use Case Examples
- Demo your app’s onboarding flow
- Capture animation effects or video players
- Scroll through an entire product page for marketing
- Generate reels or preview clips for social media
API Parameters
Optional Parameters
format
- Type: string
- Allowed:
webm
,mp4
,mov
,avi
- Default:
mp4
- Description: The video output format.
mp4
is widely supported and recommended for general use.
duration
- Type: integer
- Range:
1
to30
seconds - Default:
5
- Description: The total duration of the recording. Longer durations are useful for full scrolls or animations.
scenario
- Type: string
- Options:
video
,scroll
- Default:
video
- Description:
video
: A static screen recording, useful for animations, transitions, or video players.scroll
: Automatically scrolls the page down during recording, ideal for long-form content like blog posts.
Scrolling-Specific Options
(Only used when scenario is scroll
)
scroll_by_amount
- Type: integer
- Default:
1000
- Description: Number of pixels to scroll per step.
scroll_by_delay
- Type: integer (ms)
- Default:
500
- Description: Time to wait between each scroll step.
scroll_by_duration
- Type: integer (ms)
- Default:
1500
- Description: Duration of the scroll animation itself (smooth scroll).
scroll_back
- Type: boolean
- Default:
true
- Description: If enabled, the page scrolls back up to the top at the end.
scroll_back_delay
- Type: integer (ms)
- Default:
800
- Description: Time to wait before starting the scroll-back animation.
scroll_easing
- Type: string
- Default:
linear
- Description: Easing function applied to scrolling animations. Controls the smoothness and acceleration.
How the scroll scenario works
When using scenario scroll
option, the animation simulates a natural reading or browsing experience:
- The page scrolls down by
scroll_by_amount
pixels. - After each scroll, it pauses for
scroll_by_delay
milliseconds. - Each scroll movement is animated over
scroll_by_duration
milliseconds for smoothness. - This process repeats step-by-step until the bottom of the page is reached.
- If
scroll_back
is set to true, the page will pause forscroll_back_delay
milliseconds, then scroll back to the top in one smooth motion.
This gives the impression of a user reading or exploring the page in a relaxed and controlled way — perfect for demos, tutorials, and showcase clips.
Making Scrolls Feel Natural with scroll_easing
parameter
The scroll_easing
parameter is a powerful tool for controlling the feel of your scroll animations.,It allows you to choose how the scrolling motion behaves, making it more or less dynamic depending on your needs.
The scroll_easing
parameter affects each scroll step in the scroll
scenario, giving you fine control over the pacing and fluidity of the motion.
Why Easing Matters
A scroll that moves linearly feels robotic. Easing functions allow for acceleration and deceleration, creating a more human-like experience.
Available Easing Options
Easing | Description |
---|---|
linear | Constant speed from start to end. Feels mechanical. Good for technical demos or precise timing. |
ease_in_quad | Starts slow, speeds up. Feels like someone starting to scroll carefully, then accelerating. |
ease_out_quad | Starts fast, slows down. Great for attention-grabbing stops. |
ease_in_out_quad | Starts slow, speeds up, then slows down. Very natural. Ideal for most use cases. |
ease_in_cubic | Slower start with more punchy acceleration. A bit more dramatic than quad. |
ease_out_cubic | Strong start, smooth slow-down. Nice for relaxing endings. |
ease_in_out_cubic | Smooth acceleration and deceleration. Balanced and elegant. |
ease_in_quart | Very slow start, then rapid. Great if you want dramatic build-up. |
ease_out_quart | Fast start, very soft landing. Feels like gliding in. |
ease_in_out_quart | Cinema-style. High control with graceful motion. |
ease_in_quint | Extremely slow start and rapid acceleration. For stylized scrolls. |
ease_out_quint | Fast drop, featherlight finish. Perfect for premium UIs. |
ease_in_out_quint | Ultra-smooth and polished - high-end product demo feel. |
Need help? Contact us at support@screenshotmax.com