metadata.cacheState tells you which you got. This request always reads the page live:
For a page that changes slowly, send
"maxAge": 604800000 to accept a week old copy.
Reads that are always live
These are never answered from a stored copy and never saved as one:headers, location.languages, profile, skipTlsVerification, actions, PDF options in parsers, zeroDataRetention, storeInCache: false, and the formats screenshot, rawBase64, audio, video, network, branding and changeTracking.
Read a scrape again
GET /v1/scrape/{id} returns an earlier answer, not the current page, using metadata.scrapeId. It needs the API key of the account that sent the scrape, returns the original fields including costUsd, and adds nothing to your bill.
- Answers are kept 24 hours. After that the call returns
404 notFound:No scrape with that id. Results are kept for 24 hours. - Not kept: a scrape sent with
zeroDataRetention, one sent without an API key, and an answer with more than 4,194,304 UTF-16 code units of JSON text. - Without an API key the call returns
401 apiKeyRequired.
Limits and errors
maxAgebelow 0 or not a whole number returns400 invalidRequest. A value above 30 days is read as 30 days.minAgeorlockdownon a page with no stored copy returns404 notFound:Stophy has no stored copy of that page. Remove minAge or lockdown to read the page live.- A stored copy costs the same as a live read. A 404 or 410 page, or one that cannot be read, costs nothing. See Pricing.