Skip to main content
Plan AvailabilityAvailable 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 Need help? Contact us at support@screenshotmax.com