Reference

Reference for renders and cache behavior

Review output types, cache behavior, rate limits, and supported render parameters.

Reference

Output types

HTML

Default renderType

curl -H "Authorization: Bearer $PAGEFLASH_KEY" \
  "https://pageflash.io/render?url=https://example.com"

Screenshot

PNG or JPEG

curl -H "Authorization: Bearer $PAGEFLASH_KEY" \
  "https://pageflash.io/render?url=https://example.com&renderType=png&fullpage=true" \
  --output page.png

PDF

Print-ready export

curl -H "Authorization: Bearer $PAGEFLASH_KEY" \
  "https://pageflash.io/render?url=https://example.com/report&renderType=pdf" \
  --output report.pdf

Markdown

AI-ready text

curl -H "Authorization: Bearer $PAGEFLASH_KEY" \
  -H "Accept: text/markdown" \
  "https://pageflash.io/render?url=https://example.com/docs"

Reference

Caching and freshness

HTML and Markdown renders use the cache when possible. A cache hit does not consume monthly render quota. Cold renders and forced refreshes count as fresh browser renders.

Starter uses 1d default freshness.
Growth uses 6h default freshness, custom TTL down to 1h.
Pro uses 1h default freshness, custom TTL down to 10m.
Enterprise uses 30m default freshness, custom TTL down to 5m.

Reference

Rate limits and monthly quota

PageFlash enforces the monthly render quota before a fresh browser render starts. Cache hits stay free. When a plan runs out on a cache miss, the response code is MONTHLY_QUOTA_EXCEEDED.

Plan	Fresh renders/month	Requests/minute	Upgrade trigger
Free	500	10	One real production domain or sitemap warming
Starter	15,000	60	Multiple sites, more URLs, or sub-24h freshness
Growth	150,000	200	SEO overrides, push refresh, or many domains
Pro	600,000	500	Higher public capacity, faster freshness, or expanded SEO operations

Reference

Render parameters

Parameter	Default	Description
url	required	Absolute URL to render. Must match a registered domain.
renderType	html	html, png, jpeg, or pdf. Markdown uses Accept: text/markdown.
width	1280	Viewport width for screenshots and page layout.
height	720	Viewport height for screenshots and page layout.
fullpage	false	Capture the full document for PNG/JPEG screenshots.
waitForSelector	none	Wait until a CSS selector is visible before snapshot.
waitForFunction	none	Wait until a JS expression returns truthy.
waitForTimeout	500	Extra wait in milliseconds after readiness signals.
blockResources	true	Block heavy media for HTML renders. Disabled for screenshots.