Actions16
Overview
The node interacts with the "Library" resource of the Audiobookshelf API, specifically to retrieve items from a specified library. It allows users to fetch audiobook items stored in a particular library by providing the library's unique identifier. This is useful for scenarios where you want to list or process audiobooks available in a user's library, such as displaying them in a dashboard, syncing with another service, or performing batch operations on selected items.
Practical examples:
- Fetch all audiobooks from a specific library to display in a custom app.
- Retrieve a limited number of items for preview or sampling purposes.
- Include RSS feed data for each item to enable podcast-style consumption or updates.
Properties
| Name | Meaning |
|---|---|
| Library ID | The unique identifier of the library from which to retrieve items. |
| Include RSS Feed | Whether to include RSS feed data in the output. Options: true (include), false (exclude). |
| Return All | Whether to return all results (true) or limit the number of returned items (false). |
| Limit | Maximum number of results to return when Return All is set to false. Minimum value is 1. |
Output
The node outputs JSON data representing the items retrieved from the specified library. Each item typically contains metadata about an audiobook, such as title, author, duration, and possibly RSS feed information if requested.
If RSS feed data is included, the output will contain additional fields related to the feed, enabling podcast-like features.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential to authenticate requests against the Audiobookshelf API.
- The base URL for API requests is configured dynamically based on user-provided credentials (the domain).
- No other external dependencies are required.
Troubleshooting
Common issues:
- Invalid or missing Library ID will result in errors or empty responses.
- Network connectivity problems or incorrect domain configuration can cause request failures.
- Requesting RSS feed data without proper permissions might lead to incomplete data.
Error messages:
- Authentication errors indicate invalid or missing API credentials; verify and update the API key.
- "Not Found" errors usually mean the provided Library ID does not exist or is inaccessible.
- Rate limiting or quota exceeded errors require checking API usage limits and possibly adjusting request frequency.
Links and References
- Audiobookshelf API Documentation (general reference for API endpoints and parameters)
- n8n Documentation (for general guidance on using n8n nodes and credentials)