Advanced Analytica Advanced Analytica: IBOM
← All connectors
Gutendex logo

Source connector

Gutendex

Set up Gutendex as a source and move its data into your chosen destination.

Version 0.2.15 community alpha

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.


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.


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

  1. Log into your Airbyte Cloud account.
  2. Select Sources from the left navigation bar. Then select +new source in the top-right corner.
  3. On the Set up the source page, select Gutendex from the Source type dropdown.
  4. Select Set up source.

Airbyte OSS

  1. Open the Airbyte Open Source dashboard.
  2. Name your source Gutendex.
  3. Select Set up source.

Supported sync modes

The Gutendex source connector supports these sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncNo
NamespacesNo

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
VersionDatePull RequestSubject
0.2.152026-11-0991405Upgrade source-declarative-manifest base image to 7.47.0
0.2.142026-10-1378743Update dependencies
0.2.132026-10-0888363Replace the default Airbyte icon with a generic book icon
0.2.122025-05-2460673Update dependencies
0.2.112025-05-1059245Update dependencies
0.2.102025-04-2658752Update dependencies
0.2.92025-04-1958168Update dependencies
0.2.82025-04-1257706Update dependencies
0.2.72025-04-0557046Update dependencies
0.2.62025-03-2956636Update dependencies
0.2.52025-03-2256003Update dependencies
0.2.42025-03-0855442Update dependencies
0.2.32025-03-0154754Update dependencies
0.2.22025-02-2254345Update dependencies
0.2.12025-02-1548316Update dependencies
0.2.02024-08-2344617Refactor connector to manifest-only format
0.1.152024-08-1744264Update dependencies
0.1.142024-08-1243924Update dependencies
0.1.132024-08-1043562Update dependencies
0.1.122024-08-0343258Update dependencies
0.1.112024-07-2742701Update dependencies
0.1.102024-07-2042278Update dependencies
0.1.92024-07-1341827Update dependencies
0.1.82024-07-1041507Update dependencies
0.1.72024-07-0941244Update dependencies
0.1.62024-07-0640823Update dependencies
0.1.52024-06-2540394Update dependencies
0.1.42024-06-2339924Update dependencies
0.1.32024-06-1539509Make connector compatible with Builder
0.1.22024-06-0439017[autopull] Upgrade base image to v1.2.1
0.1.12024-05-2138509[autopull] base image + poetry + up_to_date
0.1.02022-10-17#18075🎉 New Source: Gutendex API [low-code CDK]
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.