Skip to main content
Choose between a live read and a stored copy. 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

  • maxAge below 0 or not a whole number returns 400 invalidRequest. A value above 30 days is read as 30 days.
  • minAge or lockdown on a page with no stored copy returns 404 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.
To compare a page with your last read, see Change tracking. To read on a schedule, see Monitors.