Documentation

List saved versions

GET/v1/links/{link}/snapshotsSnapshots

The link's saved copies, newest first. Free saves 50 pages a day and keeps 10 versions per link; Pro saves 1,000 and keeps 100. A page anyone saved in the last max_age seconds is reused and costs nothing.

Parameters

Parameter	Type	Required	Description
`link`	string, in the path	required	The link's id, or its ending.

Example request

curl -s "https://snip.link/v1/links/spring-menu/snapshots" \
  -H "Authorization: Bearer $SNIP_KEY"

Example response

{
  "snapshots": [
    {
      "id": "5f0f3a2e-8c1b-4b0e-9d6a-1f2e3d4c5b6a",
      "status": "ok",
      "reason": null,
      "reused": false,
      "saved_at": "2026-10-23T09:12:40.000Z",
      "captured_at": "2026-10-23T09:12:46.000Z",
      "source": "https://example.com/menus/spring-2026",
      "final_url": "https://example.com/menus/spring-2026",
      "title": "Spring menu",
      "description": "Seasonal dishes, served from March to May.",
      "formats": {
        "md": "https://snip.link/spring-menu.md?v=5f0f3a2e-8c1b-4b0e-9d6a-1f2e3d4c5b6a",
        "pdf": "https://snip.link/spring-menu.pdf?v=5f0f3a2e-8c1b-4b0e-9d6a-1f2e3d4c5b6a",
        "jpg": "https://snip.link/spring-menu.jpg?v=5f0f3a2e-8c1b-4b0e-9d6a-1f2e3d4c5b6a"
      },
      "fingerprints": {
        "markdown": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
      }
    }
  ]
}

Response fields

Field	Type	Description
`snapshots`	Snapshot[]
`snapshots[].id`	string	The version's id; `?v=<id>` on any format ending opens this version.
`snapshots[].status`	pending \| running \| ok \| skipped \| failed	pending or running: being saved. ok: saved. skipped: the page asks not to be archived (noarchive), so nothing was kept. failed: the page could not be loaded; `reason` says why.
`snapshots[].reason`	string, null
`snapshots[].reused`	boolean	True when a copy of the page saved moments earlier was used.
`snapshots[].saved_at`	string
`snapshots[].captured_at`	string, null
`snapshots[].source`	string	The address that was saved: the link's destination at the time.
`snapshots[].final_url`	string, null	Where the browser ended up, after redirects.
`snapshots[].title`	string, null
`snapshots[].description`	string, null
`snapshots[].formats`	object	Each format this version can be had in, by extension, as the short link with that ending: md, txt, html (a reading view), pdf, jpg, png, webp, avif, json (the page's facts and words), csv (its tables) and mhtml. Private links' URLs carry a signature that works for a day.
`snapshots[].fingerprints`	object, null	SHA-256 of each saved file, by file name, once saved: proof of what the page said and when.
`snapshots[].markdown`	string	The page as Markdown, with `wait`.

Errors

Status	Meaning
401	The API key is missing, malformed or revoked.
404	No link by that id or ending in this account.
429	Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (`details.reason`).

Back to getting started