# Wayback Machine API
> Web-page time travel as an API — powered by the Internet Archive's Wayback Machine, the archive of hundreds of billions of captured web pages going back to 1996. Given any URL, find out whether it has been archived and get the snapshot closest to now, the snapshot closest to a specific date (true time-travel: see a page as it looked on, say, 1 January 2010), or the very oldest capture on record — each with its exact capture timestamp and a direct link to the archived copy. It is the go-to tool for detecting and recovering from link rot, citing sources that may change or disappear, checking when a page was first archived, and digital-preservation, research and journalism workflows. A web-archival / link-rot resource — distinct from the Internet Archive's media-item library (books, audio and video). Data from the Internet Archive Wayback Machine.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/wayback-api/..."
```

## Pricing
- **Free** (Free) — 2,480 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 49,500 calls/Mo, 8 req/s
- **Pro** ($22/Mo) — 243,000 calls/Mo, 20 req/s
- **Mega** ($59/Mo) — 865,000 calls/Mo, 50 req/s

## Endpoints

### Wayback

#### `GET /v1/available` — Is a URL archived? (latest snapshot)

**Parameters:**
- `url` (query, optional, string) — A URL or domain Example: `example.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wayback-api/v1/available?url=example.com"
```

**Response:**
```json
{
    "data": {
        "url": "example.com",
        "archived": false,
        "snapshot": null
    },
    "meta": {
        "timestamp": "2026-06-01T16:22:47.284Z",
        "request_id": "077810a4-53c2-47ac-8b7a-bf39574350ef"
    },
    "status": "ok",
    "message": "Availability retrieved",
    "success": true
}
```

#### `GET /v1/oldest` — The earliest snapshot on record

**Parameters:**
- `url` (query, optional, string) — A URL or domain Example: `example.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wayback-api/v1/oldest?url=example.com"
```

**Response:**
```json
{
    "data": {
        "url": "example.com",
        "archived": true,
        "oldest_snapshot": {
            "status": "200",
            "timestamp": "20020120142510",
            "captured_at": "2002-01-20T14:25:10Z",
            "snapshot_url": "http://web.archive.org/web/20020120142510/http://example.com:80/"
        }
    },
    "meta": {
        "timestamp": "2026-06-01T16:22:49.129Z",
        "request_id": "7baa52d6-c858-4d29-a69c-98527f815aaa"
    },
    "status": "ok",
    "message": "Oldest snapshot retrieved",
    "success": true
}
```

#### `GET /v1/snapshot` — Archived snapshot closest to a date

**Parameters:**
- `url` (query, optional, string) — A URL or domain Example: `example.com`
- `timestamp` (query, optional, string) — Target date YYYYMMDD[hhmmss] Example: `20100101`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wayback-api/v1/snapshot?url=example.com&timestamp=20100101"
```

**Response:**
```json
{
    "data": {
        "url": "example.com",
        "archived": true,
        "snapshot": {
            "status": "200",
            "timestamp": "20100102003410",
            "captured_at": "2010-01-02T00:34:10Z",
            "snapshot_url": "http://web.archive.org/web/20100102003410/http://example.com/"
        },
        "requested_timestamp": "20100101"
    },
    "meta": {
        "timestamp": "2026-06-01T16:22:51.826Z",
        "request_id": "dd98f6e2-9ad6-4964-9b1d-72bf52eb6084"
    },
    "status": "ok",
    "message": "Snapshot retrieved",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Endpoint catalogue & notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wayback-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "The Wayback Machine is the Internet Archive's archive of the web — hundreds of billions of captured web pages going back to 1996. /v1/available?url=example.com tells you whether a URL has been archived and returns the most recent snapshot — its capture timestamp and a direct link to the archived copy; /v1/snapshot?url=example.com&timestamp=20200115 returns the archived snapshot closest to a given date (timestamp is YYYYMMDD, optionally with hhmmss) — true web time-travel; /v1/oldest?url=example.com returns the earliest snapshot on record (when the page was first archived). Pass a full URL or a bare domain. Data from the Internet Archive Wayback Machine. A web-archival / link-rot resource — distinct from the Internet Archive's media-item library (books, audio, video). Ideal for citation, link-rot detection, research, journalism and digital-preservation tools.",
        "source": "Wayback Machine — Internet Archive (archive.org/wayback)",
        "endpoints": [
            "/v1/available",
            "/v1/snapshot",
            "/v1/oldest",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:22:51.883Z",
        "request_id": "6f40eef7-1997-47dd-b32c-a7495683bfa2"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/wayback-api
OpenAPI spec: https://www.oanor.com/api/wayback-api/openapi.json