Audiobookshelf icon

Audiobookshelf

Work with the Audiobookshelf API

Overview

The node interacts with the Audiobookshelf API to retrieve a personalized view of a specific library. This operation is useful for users who want to fetch customized or user-specific content views from their audiobook libraries, such as recommendations or filtered collections tailored to their preferences.

Practical examples include:

  • Fetching a personalized list of audiobooks or series based on user activity.
  • Displaying a custom dashboard view of a library in an automation workflow.
  • Integrating personalized library data into other applications or notifications.

Properties

Name Meaning
Library ID The unique identifier of the library to retrieve the personalized view from. (Required)
Include RSS Feed Whether to include RSS feed data in the output. Options: true (include), false (exclude)
Return All Whether to return all results or limit the number of returned items. Options: true, false
Limit Maximum number of results to return if "Return All" is false. Minimum value: 1

Output

The node outputs JSON data representing the personalized view of the specified library. This includes details about the library's contents as customized by the Audiobookshelf service, potentially including metadata about audiobooks, series, collections, or playlists depending on the personalized view.

If the "Include RSS Feed" option is enabled, the output will also contain RSS feed information related to the library content.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Audiobookshelf API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The base URL for API requests is dynamically set from the user's credentials domain configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing Library ID will cause the request to fail.
    • Incorrect or expired API authentication token will result in authorization errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Verify that the API key credential is correctly configured and has not expired.
    • "Library not found": Check that the provided Library ID is correct and exists in the Audiobookshelf account.
    • "Limit must be a positive integer": Ensure the Limit property is set to a number greater than zero when Return All is false.

Links and References

Discussion