Actions16
Overview
This node integrates with the Audiobookshelf API to retrieve playlists from a specified library. It is useful for scenarios where you want to programmatically access and manage audiobook playlists stored in your Audiobookshelf library, such as displaying playlists in an app, syncing playlists with other services, or automating playlist-based workflows.
For example, you might use this node to:
- Fetch all playlists from a particular library to display them on a custom dashboard.
- Retrieve a limited number of playlists for quick previews or summaries.
- Automate the export of playlists to another platform or service.
Properties
| Name | Meaning |
|---|---|
| Library ID | The unique identifier of the library from which to fetch playlists. |
| Return All | Whether to return all playlists available or limit the number of results returned. |
| Limit | The maximum number of playlists to return if "Return All" is set to false (minimum 1). |
Output
The node outputs JSON data representing the playlists retrieved from the specified library. Each item in the output corresponds to a playlist object as returned by the Audiobookshelf API. The structure typically includes playlist metadata such as playlist ID, name, description, and possibly contained items.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Audiobookshelf API.
- The node expects the base URL of the Audiobookshelf instance to be configured via credentials.
- No additional external dependencies are required beyond the Audiobookshelf API access.
Troubleshooting
- Invalid Library ID: If the provided Library ID does not exist or is incorrect, the API will likely return an error or empty result. Verify the Library ID is correct.
- Authentication Errors: Ensure that the API key credential is valid and has sufficient permissions to access the library data.
- Limit and Return All Conflicts: Setting "Return All" to false but not specifying a valid "Limit" may cause unexpected behavior. Always specify a positive integer limit when not returning all results.
- Network Issues: Connectivity problems to the Audiobookshelf server will prevent data retrieval. Check network settings and server availability.
Links and References
- Audiobookshelf API Documentation (for detailed API endpoints and data structures)
- n8n Documentation (for general usage of nodes and credentials)