# Internet Archive Search and Wayback API

> Internet Archive: search books, films, audio and software, item metadata and Wayback snapshots

- Vendor: `internetarchivesearchandwaybac` · version 1.0 · category Search · tags internet archive api, wayback machine api, archive org search api, digital library api, public domain books api, item metadata api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/internetarchivesearchandwaybac
- This document: https://apiclay.com/docs/internetarchivesearchandwaybac.md
- OpenAPI 3.1: https://apiclay.com/api/internetarchivesearchandwaybac/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `internetarchivesearchandwaybac`
- Updated: 2026-11-18

## About

## Internet Archive Search and Wayback API

The public APIs of the Internet Archive, the non-profit digital library: search its collections of books and texts, films, audio, software and images with Lucene queries, choosing the fields and the sort order; the full metadata of one item with its files (name, format, size, checksum), collections and servers; and the Wayback Machine snapshot of a web page closest to a date.

Data comes from **archive.org** (https://archive.org). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?q=apollo 11&amp;fl=identifier,title,mediatype&amp;rows=10&amp;page=1`, then `/item?identifier=`; `/wayback?url=example.com×tamp=2010`.

### Routes

#### GET `/search` - Search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Lucene query, e.g. `apollo 11`, `collection:nasa`, `mediatype:texts AND year:1950`. |
| fl | query | string | no | Comma-separated fields, e.g. `identifier,title,mediatype,year,creator,downloads`. |
| rows | query | number | no | Results per page (default 50). |
| page | query | number | no | Page, from 1. |
| sort | query | string | no | e.g. `downloads desc`, `date asc`, `addeddate desc`. |

Returns: `response`: `numFound`, `start` and `docs` with the fields asked for; `responseHeader` (query, time).

#### GET `/item` - Item metadata
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| identifier | path | string | yes | Item `identifier` from `/search`, e.g. `nasa`. |

Returns: `metadata` (`identifier`, `title`, `mediatype`, `collection`, `creator`, `date`, `description`, `subject`, `licenseurl`, ...), `files` (`name`, `format`, `size`, `md5`, `mtime`), `files_count`, `item_size`, `created`, `item_last_updated`, `server`, `dir`, `reviews`. A file downloads from `https://archive.org/download//`.

#### GET `/wayback` - Wayback snapshot
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| url | query | string | yes | Page URL, e.g. `example.com/about`. |
| timestamp | query | string | no | `YYYYMMDDhhmmss` or a prefix such as `2010`; the newest snapshot without it. |

Returns: `url` and `archived_snapshots.closest`: `available`, `url` (web.archive.org link), `timestamp`, `status`; empty when the page was never captured.

### Caveats

- Rights differ by item: check its `licenseurl` and `rights` before reusing files.
- The metadata of very large items can pass 2 MB, the most ApiClay returns.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by archive.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search
- Gateway: `GET https://api.apiclay.com/v1/api/internetarchivesearchandwaybac/search`
- Public query params: `q` (string, required), `fl` (string), `rows` (number), `page` (number), `sort` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /item — Item metadata
- Gateway: `GET https://api.apiclay.com/v1/api/internetarchivesearchandwaybac/item`
- Public query params: `identifier` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /wayback — Wayback snapshot
- Gateway: `GET https://api.apiclay.com/v1/api/internetarchivesearchandwaybac/wayback`
- Public query params: `url` (string, required), `timestamp` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/internetarchivesearchandwaybac/search?q=<q>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
