maxAge
The oldest copy you will accept, in milliseconds. If our newest copy is older, or we have none, the page is fetched fresh.
3600000 accepts any copy from the last hour. 0 always fetches fresh. Leave it out for the default. The most you can set is 7 days, 604800000.0. A documentation page can take the default.
cacheOnly
Answer only from a copy, and never fetch. If there is no copy young enough, you get 404 instead.
storeInCache
Whether this read is kept as a copy for later calls. On by default. Turn it off for one-off or sensitive pages you do not want kept.
Telling a copy from a fresh read
A response from a copy says so in two places:data.cachedistrue.data.usage.freshnessiscache. A live read saysfresh.
Other endpoints
extract,images,screenshotandstyleguidetakemaxAgethe same way, with0for fresh.- In a crawl, a batch or a search with
scrapeResults, putmaxAgeinsidescrapeOptionsto apply it to every page. - News reuses a recent answer to the same search for a short time: 5 minutes for the
hourwindow, 15 fordayand 30 forweekormonth. PassmaxAge: 0to search fresh.
Next: Jobs & webhooks
Waiting for a result, background jobs and completion webhooks.