Timing, Cache, and Request Behavior

Cache (seconds)

The cache parameter sets how long (in seconds) a screenshot is considered fresh. If a screenshot for the same URL was taken within this window, the cached result is returned instead of re-capturing.

• Set to 0 to always capture a fresh screenshot.
• Default is 86400 (24 hours).

{
  "url": "https://example.com",
  "cache": 3600
}

Delay (seconds)

The delay parameter waits a fixed number of seconds after the page's load event fires before taking the screenshot. Useful for pages with animations or late-loading content.

{
  "url": "https://example.com",
  "delay": 2
}

Max wait (seconds)

max_wait is the maximum time to wait for the page to fully load. If the page hasn't loaded by this time, the screenshot is taken anyway. Default is determined by the server configuration.

Max height (px)

max_height limits the height of a full-page screenshot in pixels. Set to 0 for unlimited.

Strict SSL

When strict_ssl=true, the browser will refuse to load pages with invalid or self-signed TLS certificates. Disable this to capture internal staging sites with self-signed certs.