maxAgeMs controls how old a cached output may be. It defaults to three days (259200000 milliseconds) and accepts up to one year of 365 days (31536000000 milliseconds). Set 0 for a fresh capture. Values must be whole milliseconds between zero and the maximum; values outside that range are rejected.
Fetch a fresh page
Send this body toPOST /web/scrape. See the Quickstart for authentication and SDK setup.
Independent outputs
Each output is cached separately. One response can combine outputs captured on different visits withinmaxAgeMs; request them together with maxAgeMs: 0 when they must reflect the same visit. Changing a screenshot option need not refetch compatible Markdown.
Requests with custom headers, browser actions, or ZDR bypass the shared cache. Hosted image files refresh after 23 hours so their links remain usable.
Read cache metadata
For slower-changing pages, use
maxAgeMs: 604800000 to accept a week-old result. Failed retrievals and incomplete captures are not cached as complete outputs. Valid pieces may still be cached independently, including pieces omitted because the full response exceeded its size limit.