GET /books/
Summary: List books
Operation ID: listBooks
Auth: none
Operation ID: listBooks
Auth: none
Description
Get a paginated list of books ordered by download popularity. Supports filtering by author, language, topic, and more.
Parameters (10)
author_year_end
(integer, query, optional)
Filter by author birth year (end)
author_year_start
(integer, query, optional)
Filter by author birth year (start)
copyright
(string, query, optional)
Filter by copyright status
Constraints: {'enum': ['true', 'false', 'null']}
ids
(string, query, optional)
Comma-separated list of book IDs
languages
(string, query, optional)
Comma-separated two-character language codes
mime_type
(string, query, optional)
Filter by MIME type
page
(integer, query, optional, default: 1)
Page number for pagination
search
(string, query, optional)
Search for titles and authors
sort
(string, query, optional, default: popular)
Sort order
Constraints: {'enum': ['ascending', 'descending', 'popular']}
topic
(string, query, optional)
Search bookshelves and subjects
Examples (1)
| Title | Type | URL | Action |
|---|---|---|---|
| List books | openapi-spec |
https://gutendex.com/books/?search=frankenstein&ids=84,1342&languages=en,fr&mime_type=application/epub+zip&topic=science fiction&author_year_start=1800&author_year_end=1900 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 09:15:24.898878 | 200 | 159ms |