Audiobookshelf icon

Audiobookshelf

Work with the Audiobookshelf API

Overview

This node interacts with the Audiobookshelf API to retrieve recent episodes from a specified library. It is useful for users who want to fetch the latest audiobook episodes added or updated in their library collection. Practical applications include syncing recent content updates, displaying new episodes in a dashboard, or triggering workflows based on newly available episodes.

Properties

Name Meaning
Library ID The unique identifier of the library from which to fetch recent episodes.
Return All Whether to return all recent episodes or limit the number of results returned.
Limit The maximum number of recent episodes to return when "Return All" is set to false (minimum 1).

Output

The node outputs JSON data representing the recent episodes retrieved from the specified library. Each item in the output typically contains metadata about an episode such as title, description, release date, and other relevant details provided by the Audiobookshelf API. If binary data is included (e.g., audio files), it would be represented accordingly, but this node primarily focuses on metadata retrieval.

Dependencies

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

Troubleshooting

  • Common Issues:

    • Invalid or missing Library ID will result in errors or empty responses.
    • Network connectivity problems can prevent successful API calls.
    • Insufficient permissions or invalid API tokens may cause authorization failures.
  • Error Messages:

    • "Unauthorized" — Check that the API authentication token is correctly configured and valid.
    • "Library not found" — Verify the Library ID is correct and exists in the Audiobookshelf account.
    • "Request timeout" — Ensure network connectivity and API server availability.

Links and References

Discussion