# Internet Archive search: `POST /v1/archive/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/archive-search

One page of archive.org items matching the filters.

Each item carries identifier, title, creators, media type, year,
language, subjects, collections (personal favourites lists are
dropped), download counts, average rating, and the item, download
and thumbnail URLs. Search free text, titles or creators; filter by
media type, collection, language and year range; sort by relevance,
downloads, date, title, creator or rating. An empty page is not
charged.

Request body (JSON):

- `query` (string | null; optional; max length 500): Free text, or archive.org query syntax (e.g. 'title:(moby dick) AND year:[1900 TO 1930]').
- `title` (string | null; optional; max length 300): Match titles only.
- `creator` (string | null; optional; max length 300): Match creators/authors only.
- `mediatype` (string | null; optional; one of texts, movies, audio, software, image, data, collection, web, opensource): Keep one media type: texts, movies, audio, software, image, data, collection, web or opensource.
- `collection` (string | null; optional; max length 200): Keep one collection id.
- `language` (string | null; optional; max length 50): Language code, e.g. eng.
- `year_from` (integer | null; optional; min 0, max 9999): Earliest year (inclusive).
- `year_to` (integer | null; optional; min 0, max 9999): Latest year (inclusive).
- `sort` (string; optional; default relevance; one of relevance, downloads_desc, downloads_asc, date_desc, date_asc, title_asc, title_desc, creator_asc, rating_desc): Result order.
- `page` (integer; optional; default 1; min 1, max 10000): Results page.
- `rows` (integer; optional; default 50; min 1, max 100): Results per page (1-100).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
