List captures of a page
list_snapshotsList a web page's Wayback Machine captures from oldest to newest, showing capture dates to reveal how long and how often it has been archived. Page through older captures with a cursor.
Instructions
List Wayback Machine captures of a web page, oldest first, with the dates they were taken. Answers how long a page has been archived and how often, which get_snapshot cannot. Identical consecutive captures are collapsed, so a date marks a visit on which the page was seen to differ from the previous one. A capture records when the crawler came, not when the page changed: the change happened somewhere between two dates. This route is slow, tens of seconds on a heavily archived address, and it is paged for that reason. To walk further back, pass the 'next_cursor' from the previous answer as 'cursor'. The index counts rows rather than positions, so there is no page number and no arithmetic to do: a null 'next_cursor' means the end of what it holds.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Address to look up. | |
| limit | No | Captures to return. | |
| cursor | No | The 'next_cursor' from a previous answer. Omit to start at the oldest capture. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| last | Yes | Latest capture in this answer, not in the whole history. | |
| first | Yes | Earliest capture in this answer, not in the whole history. | |
| notes | Yes | ||
| returned | Yes | Captures in this answer. | |
| snapshots | Yes | ||
| next_cursor | Yes | Pass back as 'cursor' to read the window after this one. Null at the end of the history. |