Audiobookshelf icon

Audiobookshelf

Work with the Audiobookshelf API
Join our community

Actions16

Overview

This node integrates with the Audiobookshelf API to retrieve information about a specific library series. The "Get Series" operation fetches details of a series within a given library by its unique identifier. This is useful for scenarios where you want to display or process metadata about audiobook series stored in an Audiobookshelf library, such as listing series details in a dashboard, syncing data with other services, or generating reports.

Practical examples:

  • Fetching detailed information about a particular audiobook series to show on a website or app.
  • Automating updates or notifications based on changes in a series.
  • Integrating series metadata into a personal media management workflow.

Properties

Name Meaning
Library ID The unique identifier of the library from which to retrieve the series. (Required)
Limit Maximum number of series results to return. Default is 50. (Required)

Note: Although the input properties JSON includes "Include RSS Feed," it does not apply to the "Get Series" operation and thus is not listed here.

Output

The node outputs JSON data representing the details of the requested series from the specified library. This typically includes metadata such as series title, description, author(s), cover image URL, and other relevant attributes defined by the Audiobookshelf API.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Audiobookshelf API.
  • The base URL for API requests is configured dynamically from the provided credentials.
  • No additional external dependencies are required beyond the Audiobookshelf API access.

Troubleshooting

  • Missing or invalid Library ID: Ensure that the Library ID is correctly provided and corresponds to an existing library in Audiobookshelf.
  • API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Limit value issues: The limit must be a positive integer; values less than 1 may cause errors.
  • Network or connectivity problems: Confirm that the domain URL is reachable and the API endpoint is accessible.
  • Unexpected API responses: Check if the Audiobookshelf API version or schema has changed, which might require updating the node or its configuration.

Links and References

Discussion