# Internet Archive API: List archived snapshots of a page

> Lists Wayback Machine captures of a web page, oldest first, with HTTP status and whether the content changed since the previous capture.

Unofficial. Not affiliated with or endorsed by Internet Archive.

- Page: https://fous.com/methods/web.archive.org/list-snapshots
- Method: `web.archive.org/list_snapshots`, version 1
- Website: web.archive.org
- Returns: total_snapshots, snapshots with datetime, link, HTTP status, content_changed, digest
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `page` | string | yes | `"example.com"` | Website address to look up, for example openai.com/pricing. |
| `to_date` | string | no | `"2020-01-01"` | Last capture date to include, for example 2023-12-31. Omit for all later dates. |
| `from_date` | string | no | `"2020-01-01"` | First capture date to include, for example 2023-02-01. Omit for all earlier dates. |
| `max_results` | integer | no | `3` | Maximum captures returned, for example 50. The total still counts all matching captures. Default 50. |
| `changes_only` | boolean | no | `false` | Include only the first capture and later captures with changed content, for example true. Default true. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "page": "example.com",
  "to_date": "2020-01-01",
  "from_date": "2020-01-01",
  "max_results": 3,
  "changes_only": false
}
```

Its output:

```json
{
  "snapshots": [
    {
      "http_status": null,
      "snapshot_link": "https://web.archive.org/web/20200101002334/https://example.com",
      "content_digest": "JI6OR3QR4CI526JD6TMMNZNV4QPMPQCH",
      "content_changed": false,
      "http_status_code": null,
      "snapshot_datetime": "2020-01-01T00:23:34Z"
    },
    {
      "http_status": null,
      "snapshot_link": "https://web.archive.org/web/20200101002938/https://example.com",
      "content_digest": "JI6OR3QR4CI526JD6TMMNZNV4QPMPQCH",
      "content_changed": false,
      "http_status_code": null,
      "snapshot_datetime": "2020-01-01T00:29:38Z"
    },
    {
      "http_status": null,
      "snapshot_link": "https://web.archive.org/web/20200101012043/https://example.com/",
      "content_digest": "JI6OR3QR4CI526JD6TMMNZNV4QPMPQCH",
      "content_changed": false,
      "http_status_code": null,
      "snapshot_datetime": "2020-01-01T01:20:43Z"
    }
  ],
  "total_snapshots": 249
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"web.archive.org/list_snapshots","input":{"page":"example.com","to_date":"2020-01-01","from_date":"2020-01-01","max_results":3,"changes_only":false}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me every archived version of example-news.com/front-page from 2019 to 2021, oldest first, with status codes
- Did the pricing page at saas-tool.io/plans change between captures in 2022? List only the captures where content differed
- List up to 20 Wayback Machine snapshots of myblog.org/about since March 2015 including HTTP status and digest values
- I need the full capture history of the company's careers page at startup-corp.net through 2024-06-30, including all unchanged captures
- Give me the archived snapshots of docs.python-tips.dev/install from 2017-01-01 to 2018-12-31 and tell me which ones had content changes

## Input schema

```json
{
  "type": "object",
  "required": [
    "page"
  ],
  "properties": {
    "page": {
      "type": "string",
      "minLength": 1,
      "description": "Website address to look up, for example openai.com/pricing."
    },
    "to_date": {
      "type": "string",
      "description": "Last capture date to include, for example 2023-12-31. Omit for all later dates."
    },
    "from_date": {
      "type": "string",
      "description": "First capture date to include, for example 2023-02-01. Omit for all earlier dates."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum captures returned, for example 50. The total still counts all matching captures."
    },
    "changes_only": {
      "type": "boolean",
      "default": true,
      "description": "Include only the first capture and later captures with changed content, for example true."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "total_snapshots",
    "snapshots"
  ],
  "properties": {
    "snapshots": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "http_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "snapshot_link": {
            "type": "string"
          },
          "content_digest": {
            "type": [
              "string",
              "null"
            ]
          },
          "content_changed": {
            "type": "boolean"
          },
          "http_status_code": {
            "type": [
              "integer",
              "null"
            ]
          },
          "snapshot_datetime": {
            "type": "string"
          }
        }
      }
    },
    "total_snapshots": {
      "type": "integer"
    }
  }
}
```

## See more

- [Internet Archive API: Get archived page](https://fous.com/methods/web.archive.org/get-archived-page.md): Finds the closest Wayback Machine capture of a web page to a past date and returns its title and readable text.
- [BBC News API: Search articles](https://fous.com/methods/bbc.com/search-news.md): Finds BBC News articles matching search words, newest first or by relevance, with publication time, authors, section and summary, optionally limited to a date range. Date filters and newest order apply to the first 180 search matches; older or less relevant matches may be missed.
- [Fox News API: Search articles](https://fous.com/methods/foxnews.com/search-news.md): Searches Fox News articles by keyword, with date filtering, ordering and pagination, over the first 100 matches.
- [loc.gov API: Search historic newspapers](https://fous.com/methods/loc.gov/search-historic-newspapers.md): Searches historic U.S. newspaper pages (Chronicling America) by text, with optional state and issue-year filters. Returns relevance-ranked page records with snippets and image links; newspaper OCR may contain transcription errors.
- [National Archives API: Search records](https://fous.com/methods/catalog.archives.gov/search-records.md): Searches public National Archives Catalog records by keywords, year range, material type and online availability, in catalog relevance order.
- [CNBC API: Search articles](https://fous.com/methods/cnbc.com/search-news.md): Searches CNBC-published articles by keyword, with optional publication date range, sort order and pagination. Excludes videos, wire stories and press releases.
- [The Verge API: Search news](https://fous.com/methods/theverge.com/search-news.md): Searches The Verge articles by keyword, with optional date filters, sorting and pagination. Only the first 100 matches from The Verge search are used.
- [Wikipedia API: Get page views](https://fous.com/methods/wikipedia.org/get-page-views.md): Returns human-reader view counts for a Wikipedia article by day or month, with totals, daily averages and the peak period.
- [All Internet Archive methods](https://fous.com/methods/archive.org.md)
