> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Library

> How to set up the Open Library connector, plus the actions that are available.

<div className="connector-page-header">
  <img src="https://stackone-logos.com/api/open-library/filled/svg" alt="Open Library" className="connector-page-icon" />

  <div className="connector-page-changelog">
    <div className="connector-page-version"><span>v1.0.0</span></div>
    <div><a href="/connectors/openlibrary/changelog">See changelog</a></div>
  </div>

  <div className="connector-page-header-meta">
    <div className="connector-page-subtitle"><a href="#actions">25 actions</a> · 2 auth methods</div>
  </div>
</div>

## Getting Started

<Steps>
  <Step title="Create or Select a Project">
    Set up a new project or select an existing one. See [Organizations & Projects](/gateway/concepts/organizations-and-projects).
  </Step>

  <Step title="Configure the Connector">
    Enable the connector and set up a Connector Profile in your project. See [Setup Connector Profile](/gateway/quickstart#setup-connector-profile).

    <Columns cols={2}>
      <Card title="Connector Profile · User-Agent" href="/connectors/openlibrary/guides/connector-profile/user-agent" icon="https://stackone-logos.com/api/open-library/filled/svg" horizontal>
        No credentials, covers all read actions. Per Open Library policy, requests must identify the calling application via a U...
      </Card>

      <Card title="Connector Profile · S3 API Keys" href="/connectors/openlibrary/guides/connector-profile/s3-api-keys" icon="https://stackone-logos.com/api/open-library/filled/svg" horizontal>
        Authenticates with the Internet Archive S3 API keys of your Open Library account, enabling the list write actions on top...
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Link an account [from the dashboard](/connect/managing-connectors/linking-accounts#link-from-the-dashboard) (or via [StackOne Hub](/embed/account-linking/overview)).

    See the guide for the authentication type chosen in the Connector Profile:

    <Columns cols={2}>
      <Card title="Link Account · User-Agent" href="/connectors/openlibrary/guides/link-account/user-agent" icon="https://stackone-logos.com/api/open-library/filled/svg" horizontal />

      <Card title="Link Account · S3 API Keys" href="/connectors/openlibrary/guides/link-account/s3-api-keys" icon="https://stackone-logos.com/api/open-library/filled/svg" horizontal />
    </Columns>
  </Step>

  <Step title="Use Actions">
    Connect an AI platform to the linked account's actions. See [AI Platforms](/connect/ai-platforms/overview).

    Other ways to call actions are listed in [Protocols & SDKs](/connect/protocols-and-sdks).
  </Step>
</Steps>

## Actions

<div className="connector-meta-library-section">
  <div className="connector-actions-controls not-prose" data-connector-actions-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-actions-search placeholder="Search actions" aria-label="Search actions" />

      <div className="connector-actions-scopes" data-connector-actions-auth>
        <button type="button" className="connector-actions-scopes__toggle" data-connector-actions-auth-toggle aria-expanded="false">
          <span>Authentication type<span data-connector-actions-auth-count /></span>
        </button>

        <div className="connector-actions-scopes__menu">
          <div className="connector-actions-scopes__header">
            <input type="search" className="connector-actions-scopes__search" data-connector-actions-auth-search placeholder="Search auth methods..." aria-label="Search auth methods" />

            <div className="connector-actions-scopes__actions">
              <button type="button" data-connector-actions-auth-select-all>Select all</button>
              <span>|</span>
              <button type="button" data-connector-actions-auth-clear>Clear</button>
            </div>
          </div>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="S3 API Keys" data-connector-actions-auth-filter />

            <span>S3 API Keys</span>
          </label>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="User-Agent" data-connector-actions-auth-filter />

            <span>User-Agent</span>
          </label>

          <div className="connector-actions-scopes__empty" data-connector-actions-auth-empty hidden>No auth methods found</div>
        </div>
      </div>
    </div>
  </div>

  <div className="meta-library-count" data-connector-actions-count>25 actions</div>

  <div className="not-prose meta-library-table-container" data-connector-actions-table>
    <div className="connector-meta-library-grid">
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Action</div>
        <div className="meta-library-grid-header-cell">Description</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_reading_log" data-action-label="List Reading Log" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Reading Log</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_reading_log" aria-label="Copy openlibrary_list_reading_log"><code className="connector-page-code">openlibrary\_list\_reading\_log</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the books on a reader's shelf (want to read, currently reading, or already read)</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_recent_changes" data-action-label="List Recent Changes" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Recent Changes</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_recent_changes" aria-label="Copy openlibrary_list_recent_changes"><code className="connector-page-code">openlibrary\_list\_recent\_changes</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List recent edits made across the Open Library catalog</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_search_authors" data-action-label="Search Authors" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search Authors</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_search_authors" aria-label="Copy openlibrary_search_authors"><code className="connector-page-code">openlibrary\_search\_authors</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Search authors by name in the Open Library catalog</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_author" data-action-label="Get Author" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Author</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_author" aria-label="Copy openlibrary_get_author"><code className="connector-page-code">openlibrary\_get\_author</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get an author record by their Open Library author ID</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_author_works" data-action-label="List Author Works" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Author Works</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_author_works" aria-label="Copy openlibrary_list_author_works"><code className="connector-page-code">openlibrary\_list\_author\_works</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the works written by an author</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_search_books" data-action-label="Search Books" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search Books</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_search_books" aria-label="Copy openlibrary_search_books"><code className="connector-page-code">openlibrary\_search\_books</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Search books, works, and authors across the Open Library catalog</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_work" data-action-label="Get Work" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Work</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_work" aria-label="Copy openlibrary_get_work"><code className="connector-page-code">openlibrary\_get\_work</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a work record by its Open Library work ID</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_work_editions" data-action-label="List Work Editions" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Work Editions</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_work_editions" aria-label="Copy openlibrary_list_work_editions"><code className="connector-page-code">openlibrary\_list\_work\_editions</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the editions published for a work</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_edition" data-action-label="Get Edition" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Edition</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_edition" aria-label="Copy openlibrary_get_edition"><code className="connector-page-code">openlibrary\_get\_edition</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a book edition record by its Open Library edition ID</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_edition_by_isbn" data-action-label="Get Edition By ISBN" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Edition By ISBN</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_edition_by_isbn" aria-label="Copy openlibrary_get_edition_by_isbn"><code className="connector-page-code">openlibrary\_get\_edition\_by\_isbn</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a specific book edition by its ISBN-10 or ISBN-13</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_work_ratings" data-action-label="Get Work Ratings" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Work Ratings</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_work_ratings" aria-label="Copy openlibrary_get_work_ratings"><code className="connector-page-code">openlibrary\_get\_work\_ratings</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get the community rating summary for a work</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_work_bookshelves" data-action-label="Get Work Bookshelves" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Work Bookshelves</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_work_bookshelves" aria-label="Copy openlibrary_get_work_bookshelves"><code className="connector-page-code">openlibrary\_get\_work\_bookshelves</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get reading-log counts for a work (want to read, currently reading, already read)</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_search_inside" data-action-label="Search Inside Books" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search Inside Books</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_search_inside" aria-label="Copy openlibrary_search_inside"><code className="connector-page-code">openlibrary\_search\_inside</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Full-text search across the scanned contents of books</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_volume" data-action-label="Get Volume" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Volume</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_volume" aria-label="Copy openlibrary_get_volume"><code className="connector-page-code">openlibrary\_get\_volume</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a brief bibliographic record by identifier type and value</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_search_lists" data-action-label="Search Lists" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search Lists</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_search_lists" aria-label="Copy openlibrary_search_lists"><code className="connector-page-code">openlibrary\_search\_lists</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Search reader-curated lists by keyword</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_user_lists" data-action-label="List User Lists" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List User Lists</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_user_lists" aria-label="Copy openlibrary_list_user_lists"><code className="connector-page-code">openlibrary\_list\_user\_lists</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the reading lists created by an Open Library user</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_list" data-action-label="Get List" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get List</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_list" aria-label="Copy openlibrary_get_list"><code className="connector-page-code">openlibrary\_get\_list</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a reading list by its owner and list ID</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_list_seeds" data-action-label="List List Seeds" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List List Seeds</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_list_seeds" aria-label="Copy openlibrary_list_list_seeds"><code className="connector-page-code">openlibrary\_list\_list\_seeds</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the seeds (books, works, authors, or subjects) in a reading list</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_list_list_editions" data-action-label="List List Editions" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List List Editions</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_list_list_editions" aria-label="Copy openlibrary_list_list_editions"><code className="connector-page-code">openlibrary\_list\_list\_editions</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the book editions collected by a reading list</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_create_list" data-action-label="Create List" data-action-scopes="" data-action-auth="S3 API Keys" data-action-auth-scopes="{&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create List</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_create_list" aria-label="Copy openlibrary_create_list"><code className="connector-page-code">openlibrary\_create\_list</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a reading list on the connected Open Library account</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_update_list_seeds" data-action-label="Update List Seeds" data-action-scopes="" data-action-auth="S3 API Keys" data-action-auth-scopes="{&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update List Seeds</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_update_list_seeds" aria-label="Copy openlibrary_update_list_seeds"><code className="connector-page-code">openlibrary\_update\_list\_seeds</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add or remove seeds on a reading list of the connected Open Library account</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_delete_list" data-action-label="Delete List" data-action-scopes="" data-action-auth="S3 API Keys" data-action-auth-scopes="{&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Delete List</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_delete_list" aria-label="Copy openlibrary_delete_list"><code className="connector-page-code">openlibrary\_delete\_list</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Delete a reading list from the connected Open Library account</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_lists_containing_seed" data-action-label="Get Lists Containing Seed" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Lists Containing Seed</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_lists_containing_seed" aria-label="Copy openlibrary_get_lists_containing_seed"><code className="connector-page-code">openlibrary\_get\_lists\_containing\_seed</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the public reading lists that contain a given work, edition, or author</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_search_subjects" data-action-label="Search Subjects" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Search Subjects</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_search_subjects" aria-label="Copy openlibrary_search_subjects"><code className="connector-page-code">openlibrary\_search\_subjects</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Search subjects by name in the Open Library catalog</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="openlibrary_get_subject" data-action-label="Get Subject" data-action-scopes="" data-action-auth="User-Agent,S3 API Keys" data-action-auth-scopes="{&#x22;User-Agent&#x22;:[],&#x22;S3 API Keys&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Subject</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="openlibrary_get_subject" aria-label="Copy openlibrary_get_subject"><code className="connector-page-code">openlibrary\_get\_subject</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List works tagged with a subject</div>
      </div>
    </div>
  </div>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.