List captures of a page
list_snapshotsList Wayback Machine captures of a web page in chronological order with dates, showing archiving history and frequency. Paginate with cursor for older entries.
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. A capture whose content repeats the row before it is left out of the index answer. The index also holds one site under several addresses at once, such as its www form, its https form and a form carrying credentials, and returns them interleaved, so two consecutive rows can differ because the address differs rather than because the page did. Every row names the address it captured; read that before counting the captures of any one of them. 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. |