# Project Gutenberg Books API

> Search 75,000+ free public-domain ebooks from Project Gutenberg: authors, subjects, download links

- Vendor: `projectgutenbergbooksapi` · version 1.0 · category Content · tags project gutenberg api, free ebooks api, public domain books api, ebook search api, classic books api, gutendex api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/projectgutenbergbooksapi
- This document: https://apiclay.com/docs/projectgutenbergbooksapi.md
- OpenAPI 3.1: https://apiclay.com/api/projectgutenbergbooksapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `projectgutenbergbooksapi`
- Updated: 2026-11-18

## About

## Project Gutenberg Books API

Search Project Gutenberg's catalog of free public-domain ebooks (through Gutendex) by title, author, topic or language, sorted by popularity, and read a book's authors (with birth and death years), subjects, bookshelves, summary, download count and download links in HTML, EPUB, Kindle and plain text.

Data comes from **gutenberg.org** (https://www.gutenberg.org). Every route calls Gutendex, a public JSON API over the Project Gutenberg catalog, and returns it unchanged.

Typical flow: `/books?search=dickens&amp;languages=en`, then `/book?id=1342`.

### Routes

#### GET `/books` - Search books
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Words in title or author. |
| topic | query | string | no | Subject or bookshelf words, e.g. `children`. |
| languages | query | string | no | Comma-separated codes, e.g. `en,fr`. |
| author_year_start | query | number | no | Authors alive after this year. |
| author_year_end | query | number | no | Authors alive before this year. |
| sort | query | string | no | `popular` (default), `ascending`, `descending`. |
| page | query | number | no | Page (32 books each). |

Returns: `count`, `next`, `results[]` with `id`, `title`, `authors`, `subjects`, `languages`, `formats`, `download_count`.

#### GET `/book` - Book by id
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | number | yes | Gutenberg book id, e.g. `1342`. |

Returns: one book with `summaries` and `formats` (download links).

### Caveats

- Served by Gutendex, a community API over Project Gutenberg's catalog; the books are public domain in the US.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by gutenberg.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 /books — Search books
- Gateway: `GET https://api.apiclay.com/v1/api/projectgutenbergbooksapi/books`
- Public query params: `search` (string), `topic` (string), `languages` (string), `author_year_start` (number), `author_year_end` (number), `sort` (string), `page` (number)
- 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 /book — Book by id
- Gateway: `GET https://api.apiclay.com/v1/api/projectgutenbergbooksapi/book`
- Public query params: `id` (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.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/projectgutenbergbooksapi/books" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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