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 to 30 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:

1. The page scrolls down by scroll_by_amount pixels.
2. After each scroll, it pauses for scroll_by_delay milliseconds.
3. Each scroll movement is animated over scroll_by_duration milliseconds for smoothness.
4. This process repeats step-by-step until the bottom of the page is reached.
5. If scroll_back is set to true, the page will pause for scroll_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 [e-mail]