Every scrape endpoint accepts an optional cache_max_age query parameter. When you send it,
Scraperize will return a recent cached result — for 0 credits — instead of scraping fresh, as long as
a cached result within your chosen window exists.
Using it
cache_max_age accepts one of:
Behaviour
- Hit — a cached result within the window exists → it’s returned for 0 credits, with
meta.cached: true and meta.cachedAt (when it was scraped).
- Miss — no fresh-enough result → a live scrape runs (1 credit) and refreshes the cache.
- Omitted — leave
cache_max_age out to always scrape fresh.
Pick the largest window your use case tolerates. 30d on data that rarely changes can cut credit usage
dramatically; use 1d when you need it fresh.
