Gutendex
Overview
You can sync data from the Gutendex API with the Gutendex source.
Requirements
You don’t need an access token or API key to make requests. You can provide these optional connector parameters:
author_year_start and author_year_end
Use these to find books with at least one author alive within a specified year range. Enter positive integers for CE or negative integers for BCE.
For example, /books?author_year_start=1800&author_year_end=1899 returns books whose authors were alive during the 19th century.
copyright
Use this to find books by copyright status. Use true for existing copyrights or false for books in the USA’s public domain. Use null when copyright information isn’t available.
languages
Use this to find books in any listed language. Enter comma-separated, two-character language codes. For example, /books?languages=en returns English books. /books?languages=fr,fi returns books in French, Finnish or both.
search
Use this to search author names and book titles for specified words. Separate words with a space, or %20 in URL-encoded format. Searches are case-insensitive. For example, /books?search=dickens%20great includes Great Expectations by Charles Dickens.
sort
Use this to sort books. Choose ascending for Project Gutenberg IDs from lowest to highest. Choose descending for IDs from highest to lowest. Choose popular, the default, to sort from most to least popular by download count.
topic
Use this to search for a case-insensitive key phrase in book subjects or bookshelves. For example, /books?topic=children returns books from the “Children’s Literature” bookshelf and with subjects such as “Sick children — Fiction”.
Output schema
Query the API at /books, such as gutendex.com/books, for book information from the Project Gutenberg database. The API returns book data in this format:
{
"count": <number>,
"next": <string or null>,
"previous": <string or null>,
"results": <array of Books>
}
results is an array containing 0–32 book objects. next and previous are URLs for the next and previous result pages. count is the query’s total number of books across all pages.
By default, books are ordered by popularity, based on their Project Gutenberg download numbers.
The source can sync the results stream.
Setup guide
Step 1: Set up Gutendex in Airbyte
Airbyte Cloud
- Log into your Airbyte Cloud account.
- Select Sources from the left navigation bar. Then select +new source in the top-right corner.
- On the Set up the source page, select Gutendex from the Source type dropdown.
- Select Set up source.
Airbyte OSS
- Open the Airbyte Open Source dashboard.
- Name your source Gutendex.
- Select Set up source.
Supported sync modes
The Gutendex source connector supports these sync modes:
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental Sync | No |
| Namespaces | No |
Performance considerations
No rate limit is published. However, this data updates infrequently, so set the update cadence to 24hr or higher.
IP allow list
If you use Airbyte Cloud and your organisation restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.15 | 2026-11-09 | 91405 | Upgrade source-declarative-manifest base image to 7.47.0 |
| 0.2.14 | 2026-10-13 | 78743 | Update dependencies |
| 0.2.13 | 2026-10-08 | 88363 | Replace the default Airbyte icon with a generic book icon |
| 0.2.12 | 2025-05-24 | 60673 | Update dependencies |
| 0.2.11 | 2025-05-10 | 59245 | Update dependencies |
| 0.2.10 | 2025-04-26 | 58752 | Update dependencies |
| 0.2.9 | 2025-04-19 | 58168 | Update dependencies |
| 0.2.8 | 2025-04-12 | 57706 | Update dependencies |
| 0.2.7 | 2025-04-05 | 57046 | Update dependencies |
| 0.2.6 | 2025-03-29 | 56636 | Update dependencies |
| 0.2.5 | 2025-03-22 | 56003 | Update dependencies |
| 0.2.4 | 2025-03-08 | 55442 | Update dependencies |
| 0.2.3 | 2025-03-01 | 54754 | Update dependencies |
| 0.2.2 | 2025-02-22 | 54345 | Update dependencies |
| 0.2.1 | 2025-02-15 | 48316 | Update dependencies |
| 0.2.0 | 2024-08-23 | 44617 | Refactor connector to manifest-only format |
| 0.1.15 | 2024-08-17 | 44264 | Update dependencies |
| 0.1.14 | 2024-08-12 | 43924 | Update dependencies |
| 0.1.13 | 2024-08-10 | 43562 | Update dependencies |
| 0.1.12 | 2024-08-03 | 43258 | Update dependencies |
| 0.1.11 | 2024-07-27 | 42701 | Update dependencies |
| 0.1.10 | 2024-07-20 | 42278 | Update dependencies |
| 0.1.9 | 2024-07-13 | 41827 | Update dependencies |
| 0.1.8 | 2024-07-10 | 41507 | Update dependencies |
| 0.1.7 | 2024-07-09 | 41244 | Update dependencies |
| 0.1.6 | 2024-07-06 | 40823 | Update dependencies |
| 0.1.5 | 2024-06-25 | 40394 | Update dependencies |
| 0.1.4 | 2024-06-23 | 39924 | Update dependencies |
| 0.1.3 | 2024-06-15 | 39509 | Make connector compatible with Builder |
| 0.1.2 | 2024-06-04 | 39017 | [autopull] Upgrade base image to v1.2.1 |
| 0.1.1 | 2024-05-21 | 38509 | [autopull] base image + poetry + up_to_date |
| 0.1.0 | 2022-10-17 | #18075 | 🎉 New Source: Gutendex API [low-code CDK] |